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Preface 



Prerequisite documents 
Companion documents 



This document introduces SunView, the Sun Visual/Integrated Environment for 
workstations, that provides an advanced user interface, high-resolution graphics, 
and SunWindows, a window system, which all run on the Sun workstation. We 
assume that you have some experience with the Sun Workstation, and the UNIXf 
operating system. 

We provide examples to learn the system, not detailed explanations of the inner 
workings of the window system. However, as in each of the Beginner s Guides, 
we refer to the other Sun documentation, drawing a road map for you to follow 
when you wish to learn more about a certain topic. 

Windows and Window-Based Tools describes how to set up the window system, 
create and manipulate windows, and store window attributes. In addition, this 
manual presents examples of window-based tools, and includes special chapters 
that describe advanced window system topics, other useful features, a glossary, 
and a quick reference. 

Getting Started With UNIX: Beginner’ s Guide 

Setting Up Your UNIX Environment: Beginner s Guide 

Self Help With UNIX: Beginner’s Guide 

Windows and Window-Based Tools: Beginner s Guide 

Mail and Messages: Beginner’s Guide 

Games, Demos, and Other Pursuits: Beginner s Guide 

Doing More With UNIX: Beginner’s Guide 

Using the Network: Beginner’s Guide 

Formatting Documents on the Sun Workstation 
Editing Text Files on the Sun Workstation 
Commands Reference Manual 



t UNIX is a trademark of AT&T Bell Laboratories. 
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1.1. A Window System in Operation 3 

1.2. Parts of the Sun Workstation 4 

1.3. Cursor Versus Caret: Window System Locators 5 






The Window System 



A window system allows you to divide your screen into work areas, in which you 
can run programs, edit files, and send mail messages, just as you do when the 
screen has only one work area. 

Imagine that your workstation screen is a desktop, and the work areas on the 
screen are sheets of paper that you work on, or stack in piles, as you wish. 

With the window system, you can accomplish many tasks simultaneously by 
working on each task within its own work area. This chapter describes what the 
window system looks like, the relevant parts of the Sun Workstation, and the 
difference between a cursor and a caret within the window system. 



1.1. A Window System in 
Operation 

Figure 1-1 



Your workstation may look something like this after you log in: 
A Window System in Operation 
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When your screen looks like the previous figure, a window system is running on 
your workstation. Each of the rectangular screen sections, or work areas, is a 
window . 1 



Note: A bitmap screen allows the 
programmer to access individual 
pixels , or dots on the screen, to 
draw text and pictures. 



12, Parts of the Sun 
Workstation 



When your screen doesn’t look like the previous figure, you can run the window 
system on your workstation (you’ll learn how in Chapter 2 , on setting up win- 
dows). The window system will not run on a simple terminal; it requires a 
workstation with all of its parts, and a bitmap screen. 

To use the window system, you need to know the following parts of the Sun 
Workstation: 

□ the screen 

□ the mouse 

□ the mouse tablet 

□ the keyboard 

If you don’t remember these parts, check the chapter on the terminal screen and 
mouse in the Getting Started with UNIX: Beginner’s Guide . 



Figure 1-2 Parts of the Sun Workstation 




1 The screen illustrations in this manual were made on a system with an 1 1-point default font. If your 
system administrator chose a different default font, your screen won’t correspond exactly to the manual’s screen 
illustrations. However, if you want to set your default font size to that used for the manual, you can do so using 
de fault sedit. The SunView category has a Font attribute that you should set to 
/usr/lib/fonts/fixedwidthfonts/screen.r.ll. For more information, see the section on 
de fault sedit. Section 11.1 . 
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13. Cursor Versus Caret: You also must understand the distinction between the cursor and the caret. 

Window System Locators When we talk about the window system, the definition for cursor is unlike the 

definition we have used so far. In window system terminology, the cursor is not 
the rectangular section of screen that tracks your current type-in location on the 
screen. Instead, the window system cursor is an arrow, or sometimes a target cir- 
cle, that tracks the movements of the mouse. 2 The cursor enables the mouse as a 
locator device with which you can pick, or designate, a spot on the screen. 

The caret, then, is a small rectangular, triangular, or diamond-shaped section of 
screen that tracks your current type-in location on the screen. In some window 
applications, or tools, the caret blinks on and off or becomes only an outline of 
its former shape, a “shadow” caret 

Figure 1-3 Cursor v. Caret: Window System Locators 





In this chapter, you learned what a window system is and what it looks like. You 
reviewed the parts of the Sun Workstation and discovered the difference between 
the cursor and the caret within the window system. 



It is possible to encounter cursors of different shapes in some window-based tools. 
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Setting Up Windows 



In this chapter, you will learn how to: 

□ Start suntools 

□ Fix “stuck” mice 

□ Use the mouse to open an icon 

□ Start suntools automatically upon login 



2.1. Starting suntools To start the window system, log in to your machine, then type suntools to 

the UNIXt command prompt. 3 



Figure 2-1 


Starting suntools 






r 

venus % suntools 


a 






j 



At this point, the screen clears, then a granular gray surface appears. 4 



t UNIX is a trademark of AT&T Bell Laboratories. 

3 The command prompt is venus% in this case, because the example machine is called venus. 

4 If you get an error message, you may be trying to run the window system on the wrong equipment 
Contact someone who is using the window system or your system administrator. 
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Note: The console window is a spe- Soon, objects appear along the top of the gray background screen. Most of the 

ciai window that displays messages objects are icons, or “closed” windows, except for one window, the console 

about the status of the system. r , . . A T , , , . 

window, that is open. An icon is a little drawing that represents a closed win- 
dow. You must open an iconic window before you can type commands to the 
window, sunt oo Is is ready for your instructions when the screen looks like 

this: 



Figure 2-3 sunt ools Screen : Ready for Instructions 
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The amount of time it takes for suntools to start depends on the number of 
tools you want it to initiate and display on the screen.^ 

Though it is inconspicuous at first glance, look for the black arrow somewhere on 
the gray screen, usually in center screen pointing “northwest.” That is the cur- 
sor. 

To move the cursor, push the mouse about on its tablet. Make sure that the 
mouse’s “eyes” are on its underbelly, in other words, the mouse buttons are on 
top; then, the mouse can read the lines on the tablet to indicate relative position 
on the screen. Also, make sure to orient the mouse perpendicular to one of the 
long sides of the tablet, so that the cursor responds appropriately when you move 
the mouse — if the cursor doesn’t respond properly, rotate the mouse on the 
tablet, then try moving the cursor again. 

Figure 2-4 Moving a Mouse on Its Tablet 




2.2. “Stuck” Mice: No If the cursor won’t move when you push your mouse on its tablet, your mouse 

Cursor Movement may be ‘ ‘stuck.” Try pushing the mouse rapidly in large circles on the tablet 

several times. The mouse should then start to control the cursor position. 6 



5 See the chapter on storing window attributes to learn about controlling the number of windows on the 
screen just after starting suntools. 

6 If the mouse still won’t control the cursor position, check to make sure it is plugged in to your workstation 
without a loose connection. If that fails to solve the problem, unplug the mouse from the workstation and plug 
it in again. If it still doesn’t work, the mouse or the workstation may be defective — contact your system 
administrator. 



Asun 

microsystems 





12 



23 . Open a Window 



Figure 2-5 




Enlarged view 



Note: A shell, or command inter- 
preter, is the piece of software that 
translates the commands you type 
so the UNIX operating system can 
understand and act on them. 



There it is — the suntools screen. What useful things can you do with it? 

Push the mouse so as to move the cursor onto the small rectangular icon that 
looks like this, the shelltool icon: 

Shelltool Window Icon 




Make sure to pick the shelltool icon above, not one of the other two icons 
on the screen. 7 

In this case, the shelltool icon represents a closed, or iconic, shelltool. 
In fact, each icon represents not a window, but a tool, in other words, a window 
application program that creates windows. 

A shelltool is one type of tool, shelltools ran the shell, or the com- 
mand interpreter , that you have typed UNIX commands to all along. With 
shelltools that run only within suntools, you can have several windows 
running the UNIX command interpreter on the screen simultaneously. 

To open the iconic shelltool window, move the cursor over the 
shelltool icon and click, or press and release, the left mouse button. An 
open shelltool appears in the gray surface of the screen. 8 



7 You will learn about the textedit and mailtool icons in the chapter on window-based tools. 
Chapter 7 . 

8 Window system performance may deteriorate when your machine doesn’t have enough memory or runs 
too many programs in the background. When your machine is a client machine of an overloaded file server, 
performance slows as well. If the window system seems sluggish, contact your system administrator to 
understand and remedy the difficulty. 



#sun 

V microsystems 





Chapter 2 — Setting Up Windows 1 3 



Figure 2-6 




Enlarged view 



Note: The window frame comprises 
the namestripe across the top of the 
window, and the borders on the 
other three sides of the window. 



Open shelltool Window 




You can use the “left-click” method of opening an iconic window with any of 
the icons on the screen. 

To make use of the window, you must move the cursor within the borders of the 
window. Locating the cursor on the window frame will not allow you to type in 
the window — you must move the cursor entirely inside the window. 

The system confirms your window choice by filling in the window border. Try 
moving the cursor slowly in and out of the window to see how the window 
border changes. 9 



9 If the system does not confirm your window choices by darkening the window bonier, it may be operating 
with the “click-to-type’ ’ method for choosing windows. See the chapter on focusing attention (Chapter 14 .) 



©sun 

V microsystems 





14 



Figure 2-7 Border Changes When Choosing a Window 




You can type commands to the command prompt within the window just as you 
typed commands to the prompt you used before starting suntools. For exam- 
ple, try creating a file using cat >, looking at it with more, and listing your 
working directory with Is. Notice that whenever the cursor wanders outside of 
the window, your typing no longer appears in the window. You can’t do work in 
that window until you move the cursor into the window again. 10 



2.4. Starting suntools 
Automatically Upon 
Login 



If you want suntools to start automatically when you log in on your worksta- 
tion, insert the following lines at the end of your . login file: 

if ( "'tty'” == "/dev/console" ) then 
echo "Do you want windows?" 
echo "If not type ~C now" 

/usr /bin/ suntools 

endif 

Then, when you log in, the system will display 

Do you want windows? 

If not type A C now 

on your screen. If you don’t type ( CTRL-C 1 within a second or two, sun- 
tools will start. 



10 To learn about “click-to-type,” an alternative to the “cursor-in-window” method of choosing a window, 
see the chapter on focusing attention. Chapter 14 . 
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23. Summary 



Now that you know how to start suntools, fix “stuck” mice, and open an 
iconic window, you can leam how to modify the open window on the screen. 
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Modifying Windows 



This chapter explains how to modify windows, specifically how to: 

□ change the location of, or move , a window 

□ change the size of, or resize, a window 

□ open and close windows 



3.1. Modifying Your Window To modify the window you opened in the last chapter, you can use the frame 

menu. The frame menu allows you to modify individual windows. 



Pop Up the Frame Menu 



Note: When you pop up a menu, 
you make it visible on the screen. 
The frame menu that firist appears 
is an old-style menu, unless you 
change the style, as described in 
the section on walking menus (Sec- 
tion 8.2 ), in which case the header 
Frame doesn’t appear at the top of 
the frame menu. 



Move the cursor to the namestripe across the top of the window. Then, pop up 
the frame menu by pressing, and holding down, the right mouse button while the 
cursor is over the window frame (the namestripe or border of the window). 

When you move the cursor onto the window frame, a small target circle cursor 
with a dot in the center appears. Pop up the menu by pressing, and holding 
down, the right mouse button. 



Figure 3-1 Target Circle for Popping Up a Frame Menu 
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Figure 3-2 The Frame Menu 




Note: When you select an item 
within the menu box, the window 
system notifies you of your choice 
by reversing the colors of the rec- 
tangular item area you have 
selected. When you release the 
mouse button, the window system 
executes the item you chose. If you 
don’t select anything, nothing hap- 
pens. 

Changing the Location of a How can you move the window from its current screen location to your favorite 
Window spot on the vast expanse of unadulterated gray screen? 

Here are the steps: 

□ Pop up a frame menu by pressing the right mouse button while the cursor is 
in the window namestripe, or targeting a window border 

□ Keep holding the right mouse button down 

□ Choose the Move item by moving the cursor into the menu item rectangle 

□ Release the right mouse button (the menu box disappears) 

□ Read the instruction box that appears on the screen 



The frame menu has the abbreviation Frame as its header. Notice that the cur- 
sor changes — it points due ‘ ‘east’ ’ when you pop up a menu. That is so that 
you can choose a menu item, such as Move to change the location of a window. 

When you decide not to choose a menu item, move die cursor outside the menu 
box, and release the right mouse button. The menu box will disappear. 
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□ Drag the window to the desired location by pressing, and holding, the left or 
middle mouse button and using the mouse to move the window’s boundary 
box 

□ Release the mouse button 1 1 

Here are some illustrations of these steps: 



Figure 3-3 Choosing the Move Item in the Frame Menu 




11 For a quick method of changing window location without using a menu, see the chapter on accelerators, 
Chapter 13 . The quick reference appendix provides a quick reference to the function keys and most of the 
accelerators. 




Note: A boundary box is a rectangle 
that defines the boundary, or bord- 
ers of a window. So, when chang- 
ing window locations, the boundary 
box informs you where the window 
will settle after you release the 
mouse button. 
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Figure 3-4 The Instruction Box for Moving Windows 




You can drag the window boundary box in one of two ways, constrained or 
unconstrained , depending on where on the window frame you put the cursor. 

When you press the left or middle mouse button while the cursor is on the middle 
third of the window namestripe or any window edge, you can drag the window 
side, or edge, along a constrained path. The constrained path is horizontal when 
you pick the left or right window edge; it is vertical when you pick the names- 
tripe or the bottom edge of the window. You move the mouse so that the con- 
strained movement cursor indicates the new window position, then release the 
mouse button. 
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Enlarged view 



When instead you press the left or middle mouse button while the cursor is 
within one-third edge length of a window comer, you can drag the window 
comer along an unconstrained path. The unconstrained path is horizontal, verti- 
cal, or diagonal, depending on how you move the unconstrained movement cur- 
sor. Release the mouse button to fix the window in the new position that you 
desire. 

Figure 3-6 Dragging a Window Boundary Box: Unconstrained 
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When you can see the instruction box and you want to cancel the moving opera- 
tion, simply click the right mouse button, as indicated in the instructions, and the 
instruction box will disappear without changing the location of die window. 

Change the location of this window a few times, so you can familiarize yourself 
with the process. 



Resizing, or Changing the Size Resizing, or changing the size of a window, is similar to moving a window. Fol- 
of a Window low these steps: 

□ Pop up a frame menu 

□ Choose the Resize item in the menu 

□ Release the right mouse button 

□ Read the instruction box that appears on the screen 

o Specify the desired window size by pressing the left or middle mouse button 
and using the mouse to move the window’s boundary box 

□ Release the mouse button 
Here are some illustrations: 



Figure 3-7 Choosing the Resize Item in the Frame Menu 



Expose 

Hide 

Redisplay 

Quit 



Enlarged view 
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Figure 3-8 The Instruction Box for Resizing Windows 




You can adjust the window boundary box in one of two ways, constrained or 
unconstrained, depending on where on the window frame you put the cursor. 



When you press the left or middle mouse button while the cursor is on the middle 
third of the window namestripe or any window edge, you can adjust the window 
side, or edge, along a constrained path. The constrained path is horizontal when 
you pick the left or right window edge; it is vertical when you pick the names- 
tripe or the bottom edge of the window. You move the mouse so that the con- 
strained resizing cursor indicates the new window position, then release the 
mouse button. 
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Figure 3-9 Adjusting a Window Boundary Box: Constrained 




Enlarged view 




When instead you press the left or middle mouse button while the cursor is 
within one-third edge length of a window comer, you can adjust the window 
comer along an unconstrained path. The unconstrained path is horizontal, verti- 
cal, or diagonal, depending on how you move the unconstrained resizing cursor. 
Release the mouse button to fix the window in the new position that you desire. 



Figure 3-10 



Adjusting a Window Boundary Box: Unconstrained 
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The instruction box notes that you can cancel the resizing operation by clicking 
the right mouse button, rather than continuing to size the window boundary 
box. 12 



Closing and Opening a Sometimes it is useful to “close’ ’ a window, or transform it into an icon. You 

Window might want to close the window while you aren’t using it, so that the window 

doesn’t take up as much space on the screen. 

An icon is a little drawing that represents a closed window. Each type of win- 
dow has its own icon. (You’ll read more about types of windows in Chapter 7 on 
window-based tools.) 



Figure 3-11 Some Common / cons 




You can type commands to open windows, but not to closed windows. 13 How- 
ever, an iconic window will continue to execute commands that you typed before 
you closed the window. 

To close a window, follow these steps: 

□ Pop up a frame menu 

□ Choose the Close item in the menu 

□ Release the right mouse button 14 



12 For a quick way to resize windows without using a menu, see the chapter on accelerators. Chapter 13 . 
The quick reference appendix provides a quick reference to the function keys and most of the accelerators. 

13 per f me t e r is one exception; see its Man Page, online or in the Commands Reference Manual. 

14 For a quick way to close windows without using a menu, see the chapter on accelerators. Chapter 13 . 
The quick reference appendix provides a quick reference to the function keys and most of the accelerators. 
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To open a window that is in its iconic state, follow these steps: 

□ Pop up a frame menu by pressing the right mouse button while the cursor is 
anywhere in the iconic rectangle 

□ Choose the Open item in the menu 

□ Release the right mouse button 



Figure 3-14 Choosing the Open Item in the Frame Menu 




When you first started to use the window system, you opened a window by click- 
ing the left button once on the appropriate icon. That is a fast way to open a win- 
dow, known as an accelerator . 15 

Try opening and closing the window a couple of times to make sure you’ve got 
the idea. 

You’ve learned how to move, resize, open, and close a window. Next, you can 
learn how to create a window “from scratch.” 



1S See the chapter about accelerators, Chapter 13 
to the function keys and most of the accelerators. 



The quick reference appendix provides a quick reference 
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4.1. Creating Application 
Windows 



Pop Up the Root Menu 



Figure 4-1 




Enlarged view 



Creating Application Windows 



When you want more than one shelltool, or when you don’t see a 
shelltool icon on the screen, you can create a shelltool “from 
scratch.” 



To create a new shelltool, use another menu, called the root menu. You 
can use the root menu to create application windows, exit suntools, and a 
variety of other functions. 

For now, however, you want to create a shelltool. To pop up the root 
menu, move the cursor onto a gray area of the screen, approximately where you 
want the menu to appear. 



Press the Right Mouse Button When the Cursor Is On Gray 
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Then, press the mouse button on the right side of the mouse and hold it down. A 
menu that looks like this appears: 



Figure 4-2 The Root Menu 





ShellTool 


CommandTool 


Mai ITool 


TextEdi tor 


Def aul tsEdi tor 


IconEdi tor 


ObxTool 


PerfMeter 


Sraphi csTool 


Console 


Lock Screen 


Redisplay fill 


fexit Suntools 



Enlarged view 




This is the root menu, with the word Sunt oo Is as its header. Just as with the 
frame menu, the cursor changes — it points due east when you pop up a menu. 
That is so that you can choose a menu item, such as She 11 Tool, to create a 
window. 

When you decide you don’t want to choose any of the menu items, just move the 
cursor away from the menu box and release the right mouse button. The menu 
will disappear. 



4.2. Creating a Window To create a she 11 tool, you must choose the ShellTool entry, the first 

item in the root menu. Here are the steps: 

o Pop up the menu (press the right mouse button) 

□ Keep holding the mouse button down 

□ Move the cursor into the ShellTool rectangle within the menu box 

□ Release the mouse button 
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Figure 4-3 Choosing ShellTool Item on Root Menu 
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Enlarged view 




A new window appears, usually in the upper center of your screen. At first, the 
window is empty, with only a namestripe describing the window, for instance: 

Shell Tool 3.0: /bin/csh 

Then, the command prompt appears. 

Figure 4-4 Creating a Window 
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You have created your first window using the window system. 
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Manipulating Windows 



The chapter explains how to: 

□ expose and hide windows 

□ redisplay a window, or all of the windows 

□ quit a window, or exit the entire window system 



5.1. Playing With Multiple 
Windows 



A big advantage of the window system is that you can create more than one win- 
dow and run different commands and programs simultaneously, each program in 
a window you have created. 



Note: When you move the cursor 
into a window to start typing, the 
window border shading changes, 
confirming your choice of window. 



Move the shelltool window you created at die end of the last chapter so that 
you can type to the command prompts on both windows. Then, move the cursor 
into one shelltool window, and cat a long file, like /usr /lib/units. 
Next, move the cursor into the other window and type date to find out the 
current date and time. 



Figure 5-1 Playing With Multiple Windows 



*a* 

*b* 

*c* 




Enlarged view 
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One window continues displaying the file, while you type to the other window. 
You can work more efficiently by running multiple programs simultaneously in 
various windows. 

Exposing Windows When you create new windows, sometimes they may overlap. One way to make 

visible a window that is “hidden” behind another window is to move that win- 
dow out from behind the other window. Or, you can expose the window that is 
hidden, using the Expose item on the frame menu. Exposing a window is like 
shuffling a piece of paper from the middle or bottom of a pile of papers on your 
desk to the top of the pile. 

When you want to expose a window, follow these steps: 

□ Move the cursor onto the border or namestripe of the window to get the 
frame menu 

□ Choose the Expose item in the menu box 

□ Release the right mouse button you used to pop up the menu 

Each time you create a window, it appears on top of the pile. To try exposing a 
window, move the window that is on top of the pile — in other words, the win- 
dow you just created — so that it covers, or hides, another window. Try expos- 
ing the window that is hidden behind the one you just created. 



Figure 5-2 Exposing a Window: Choosing the Expose Menu Item 
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Hiding Windows 




The window you expose shuffles to the top of the pile of windows on the screen. 
Figure 5-3 Exposing a Window: After It’s Exposed 



At other times, you may want to hide a window behind some others because you 
don’t need it for a while, just as you might shuffle a sheet of paper to the bottom 
of the pile of papers on your desk. 

To try hiding a window, move the window that is on top of the pile, so that it 
covers, or hides, another window. 

Now, hide the front window behind the window it obscures by following these 
steps: 

□ Move the cursor onto the border or namestripe of the window to get the 
frame menu 

□ Choose the Hide item in the menu box 

□ Release the right mouse button you used to pop up the menu 
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Figure 5-4 Hiding a Window: Choosing the Hide Menu Item 




The window you hide shuffles to the bottom of the pile of windows on the 
screen. 16 



Figure 5-5 Hiding a Window: After It’s Hidden 




16 For a quick way to expose and hide windows, see the chapter on accelerators, Chapter 13 . The quick 
reference appendix provides a quick reference the function keys and most of the accelerators. 
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Redisplaying a Window Occasionally, the contents of a window may become garbled. You can redisplay, 

or draw the window again, by choosing the Redisplay item on its frame 
menu. 



Redisplaying All of the 
Windows 



If most or all of the windows on the screen become garbled, redisplay the entire 
screen by choosing the Redisplay All item in the root menu. 



Figure 5-6 Redisplaying All of the Windows on the Screen 
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Enlarged view 




Note: Put only one console window 
on your screen at a time to prevent 
confusion. 



Always keep a console window on your screen, so that system messages don't 
flash onto the entire screen, or alternate windows, disturbing your work. When 
you don’t have a console window on the screen, you can create one by picking 
the Console entry on the root menu. 



Quitting a Window When you want to get rid of, or quit, a specific application, choose the Quit 

item on its frame menu. The window system displays an instruction box and 
asks you to click the left mouse button to confirm the quit, or the right mouse 
button to abort the quit When you confirm, the window disappears. When you 
abort, the window remains. 17 



17 For now, there is no accelerator, or quick way, to quit windows. 
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Figure 5-7 



Exiting the Window System 



Quitting a Window : Instruction Box 



t sc«tr% date 

un Dec 15 13: 10: 28 PST 1985 
scar% ■ 



Press the left souse button 
to confirm Quit. To cancel, 
press the right souse button 
now. 



When possible, try to exit from any programs you have running in the window 
before quitting the window. 



Sometimes, you may want to exit suntools, getting rid of all the windows 
and the gray screen background at once. Rather than quitting each individual 
tool, you can choose die Exit Suntools item on die root menu to exit 
suntools entirely. Once again, the window system will print the confirmation 
instruction box. When you want to confirm the exit, click the left mouse button. 
When you want to abort the exit, preserving all of your window tools for further 
use, click the right mouse button. 

Before exiting the window system, make sure that any long-running programs 
have finished execution, so that you don’t destroy the partial result of the pro- 
gram. 

In this chapter, you learned how to run programs simultaneously in more than 
one window, and how to hide, expose, redisplay, and quit a window, or the win- 
dow system. You’ve covered the basics of window-based tool setup, 
modification, creation, and manipulation. 
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Storing Window Attributes 



After you experiment with the window system for a while, you may wonder how 
to store the attributes of the window-based tools that you have created, including 
the window locations and sizes, for reuse. When you store these window attri- 
butes, then each time you start suntools you can continue with the window 
set up the way they were when you stored them. 



6.1. toolplaces 



toolplaces is a command that displays the attributes of the windows that you 
have on the screen. Type toolplaces to see what it does. 



Figure 6-1 



Note: The line starting with -wl 
“wrapped around,” continuing tram 
the end of the previous line. 



Running toolplaces 
r 

venus % toolplaces 

cradtool -Wp 0 0 -Ws 570 67 -WP 0 0 -Wl •'<< CONSOLE »" 

-WL console -C 



clock. 


-Wp 


568 


0 


-Ws 


192 


31 


-WP 


572 


0 


-Wi 


textedit 


-Wp 


283 


165 


-Ws 


584 


576 


-WP 


708 


0 


-Wi 


mailtool 


-Wp 


568 


66 


-Ws 


CO 

lO 


555 


-WP 


776 


0 


-Wi 


shelltool 


-Wp 


106 


67 


-Ws 


638 


790 


-WP 


640 


0 




shelltool 
venus % 


-Wp 


126 


164 


-Ws 


570 


427 


-WP 


64 


0 





v ; 



Note: The filename .suntools 
begins with a dot, or period charac- 
ter, so it won’t show up in a regular 
file listing with is, unless you 
specify explicitly the filename. See 
the example listing below. 



You can redirect the output of toolplaces into a file. By redirecting the out- 
put from toolplaces into a file called . suntools in your home directory, 
you can store the current attributes of the windows on the screen. When starting, 
suntools looks at the . suntools file in your home directory, if you have 
one, so it can reproduce the window attributes you store there. 
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Note: Remember that the tilde To store your current window attributes, create all of die windows you want, 

character ( ) is an abbreviation for move them, resize them, and open or close them, then type toolplaces > 
your home directory. . f . 1, , 

~/ . suntools to a command prompt in one of the shelltools. Make sure 

to put a dot ( . ) at the beginning of the filename . suntools. 18 
Figure 6-2 Storing Window Attributes with toolplaces 




Exit the window system by choosing Exit Suntools on the root menu. 
Then, restart the window system by typing suntools to your command 
prompt suntools looks at the . suntools file to decide how to set up the 
windows on your screen. 19 

Give the windows time to appear. The window system should display all of the 
windows, in the appropriate locations and sizes, that you had on the screen when 
you stored them with toolplaces. 

6.2. The . suntools File After creating a . suntools file with toolplaces, you can look at it This 

section describes the format of the . suntools file. 

Here is what the . suntool s file would look like if you stored your window 
attributes with toolplaces just after starting suntools. 

Figure 6-3 Default . suntools File 



— 

venus % cat 


~ / . suntools 






> 


cmdtool 


-Wp 0 0 -WP 


0 


0 


-Wh 4 -Ww 80 


i -W1 "« CONSOLE »" -WL " 


console 


ff 


-C (Continuation of the first line.) 


clock 


-Wp 568 0 -WP 


572 


0 


-Wi -Wh 1 


shelltool 


-Wp 0 66 -WP 


640 


0 


-Wi -Wh 58 -Ww 80 


text edit 


-Wp 283 165 -WP 


708 


0 


-Wi 


mailtool 


-Wp 568 66 -WP 


776 


0 


-Wi 


venus % 

s 











Each line of the . suntools file can specify: 
name the tool name 

— Wp x-position y-position location of the window 

— Ws pixel-width pixel-height size of the window 

18 For more information on toolplaces, see the Man Page online, or in the Commands Reference 
Manual. 

19 When you don’t have a .suntools file in your home directory, suntools finds a default 
. suntools file in one of the system directories. 
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— WP x-icon-position y -icon-position 

location of the icon 

-Wi iconic (closed if -Wi is present) 

— W1 namestrip e-label namestripe label 

-WL icon-label icon label 

-WI filename alternate icon image 

-Wt filename alternate font 

-Wb / f / g color control 

program program (only for sh e 1 1 1 oo 1 and 

cmdtool; after other specifications) 

options program options (only for shelltool and 

cmdtool; after other specifications) 

For more information on the . suntools file format, see the suntools Man 
Page, online or in the Commands Reference Manual. 

Note: You can type to the console 
window just like any shelltool 
window, although system messages 
may occasionally flash onto the win- 
dow. 

You have learned how to store your window attributes for reuse. 



When you first started suntools, several iconic windows and a console win- 
dow appeared, even though you didn’t have a . suntools file. When sun- 
tools doesn’t find a . suntools file in your home directory, it looks for the 
default . suntools file, / usr/lib/ . suntools. Look at the default 
. suntools file figure above. 
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Window-Based Tools 



This chapter describes the wide variety of window-based tools supported by the 
window system. All of the icons that appear at die top of your screen when you 
you start sunt ools are closed window-based tools of various types. This 
chapter lists the window-based tools, and describes clock, perfmeter, and 
shelltool. Later chapters, and other documents, describe the rest of the tools. 



7.1. List of Window-Based Here is a list of the window-based tools presently available on the Sun system 

Tools (illustrations of the iconic tool are in the margin; the open tool appears within the 

body of the text): 

suntools 

The program that permits all of the window-based tools to run on the 
workstation screen. 

clock 

A clock on your screen that displays the current date and time. See Sec- 
tion 7.2 . 
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perfmeter 

A “meter” on your screen that displays various system performance 
statistics. See Section 7.3 . 
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shelltool icon 



shelltool 

You’ve used shelltool, a UNIX shell in a window, already. See 
Section 7.4 . 
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mailtool 

A window and mouse mail program. See Mail and Messages: 
Beginner’s Guide. 



mai Itool - folder: /usr/spool/mai 1/test 



! aedic1 
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Hon Nov 18 11: 12 
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S-S'K 
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dbxtool 

A window and mouse debugging tool, based on the dbx debugging 
program. See Program Debugging Tools for the Sun Workstation. 
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defaultsedit icon 



def aultsedit 

A window application that permits you to change the default parameters 
of the window system you run on your workstation. See Chapter 1 1 . 



defaultsedit 




Cl i ck_to_7ype 


(Disabled) 


0 Disabled 


Font 


() 


A 


WalkingMenus 


(Disabled) 


0 Disabled 


Rootmenu filename 


() 




Icon_gravity 


(North) 


0 North 


Icon_cl ose_l evel 


(Ahead_of_al 1 ) 


0 Ahead_of_al 1 


Jump_cursor_on_ resize 


(Disabled) 


0 Disabled 


AudibleBell 


(Enabled) 


0 Enabled 


Visible_Bell 


(Enabled) 


0 Enabled 


Ttysubuindou /Retained 








HI 
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iconedit 

A tool that permits you to build your own window icons. See Chapter 

11 . 
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tektool 

A window that emulates , or acts like, a Tektronix 4014 ™ terminal. See 
Chapter 12 . 
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gammontool 

A window-based backgammon game. See Games, Demos, and Other 
Pursuits: Beginner* s Guide. 




gammontool icon 



iamwion Tool Z , u 



ftloub'le j [Hccept Doutne) [Refuse Double] [5bou Last hove) [Redo Hove) 

l* ? do GSSSD CE5S) (i!s* Color: ST White □ Black 

begin the ga»e, roll the'dVce by clicking the 1eK or aiddie buttons. 
||(The wouse cursor nay be anywhere over the board when rolling the dice.) 




lockscreen 

A program that “locks” the screen and displays the life graphics 
demo on it, until you give it your password to resume your work with 
the screen display as you left it before you ran lockscreen. See 
Section 17.1 in the chapter on other features of the window system, 
lockscreen has no icon. 
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7.2. clock 



73. perfmeter 



Stacking Menu 



clock displays the current date (day of the week, month, day of month, year) 
and time (hour, minute, and second) in the form of a digital clock when open, 
and an analog clock when closed. 

To start a clock, type clock & to a shelltool command prompt. The 
ampersand character runs c lo ck in the background of the shelltool where 
you started clock, so you can still type commands to that shelltool. 

clock without any options looks like this: 

Figure 7-1 clock Without Any Options 




clock has a number of options. For example when you want a clock that, while 
iconic, tells time in roman numerals with a “sweep” second hand and shows the 
date in the form day, date, and month, type clock -S -r -d wdm. For 
more information on clock and its options, see its Man Page, online or in the 
Commands Reference Manual. 



perfmeter, or performance meter, provides a variety of statistics on the per- 
formance of the system. Simply choose the Per f Meter item on the root 
menu, or type perfmeter (followed by & when you want to ran the tool in 
the background), to start up the tool, then use the frame menu to explore possibil- 
ities. 



perfmeter has a stacking menu, an extension of the old-style menu you have 
seen so far. When you see a menu with overlapping parts, you can access any of 
the hidden menu items by: 

□ holding down the right mouse button 

□ moving the cursor onto the header of the hidden menu 



#sun A of 17 February 1986 

V microsystems 






62 



□ clicking the left mouse button 

Then, continue to hold the right mouse button down, and move the cursor to 
choose items on the previously obscured menu portion. 

Figure 7-2 per f meter and Stacking Frame Menu 
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To find out more about the system statistics available, and about per f meter 
in general, see the Man Page, online or in the Commands Reference Manual. 



7.4. shelltool shelltool is the window-based tool that you used prior to this chapter. 

shelltool runs the basic UNIX command interpreter, or shell, within a win- 
dow, so you can type UNIX commands as you would when you aren’t running 
suntools. 

7.5. textedit textedit is the primary file editing application for the SunView text facility. 

The next chapter describes textedit and the text facility. 
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Note: A subwindow is an area of the 
screen surrounded by a frame, or 
border and namestripe. More than one 
subwindow may fit inside a frame, 
although subwindows must be tiled; 
they can’t overlap. 



8.1. Setting Up Function Keys 



Editing and the Text Facility 



This chapter is an introduction to the mouse-oriented, cut-and-paste text facil- 
ity?® 

A text subwindow is a subwindow that provides display and editing capability for 
text within the text facility. The text facility permits various operations on text 
that appears in text sub windows, like find a character span or undo changes since 
the last selection. 

A growing collection of applications are built on text subwindow capabilities, 
such as text edit for files, cmdtool for UNIX command interpretation, 
mailtool for mail operations, and dbxtool for program debugging. 

Make sure to read the sections on setting up your system so you can use the func- 
tion keys to invoke text facility operations, and using the new style of SunView 
menu called a walking menu , prior to reading the section in which you experi- 
ment with the text facility operations. 



Text facility function keys invoke text operations. The ten text facility function 
keys are: [ Stop) . I Again 1 . 1 Props I . [Undo) . [ Expose) . ( Put) . [ Open 1 . ( Getl . 

[ Find) , and ( Delete 1 . In addition, you could consider the [ Caps Lock 1 key that 
you label as a function key. 

You can locate the text facility function keys on one side or the other of your key- 
board (except for the Sun-1 keyboard). To set up your function keys properly, 
find out what kind of keyboard you have: Sun-1, Sun-2, or Sun-3. 

If, like most people, you have a Sun-2 or Sun-3 keyboard and want to move the 
mouse with your right hand, then you probably don’t have to change anything. 
Right-handed mouse users with Sun-2 or Sun-3 keyboards use the keys 1 LI 1 
through I Lit) 1 . located on the left of the keyboard, as their function keys. 

However, with a Sun-2 or Sun-3 keyboard, you can specify on which side of the 
keyboard you want the function keys using a program called setkeys. Right- 
handed people usually prefer to have function keys on the left side of the key- 
board, because they can wield their mice on the right, while typing editing 



20 The text facility programming interface documentation appears in the chapter on text subwindows in the 
SunView Programmer’s Guide. 
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function keys on the left. “Left-moused’ ’ people, however, prefer to wiggle 
mice on the left, typing function keys on the right (using IR1 1 . 1 R41 . [R71 . 

Sun-1 keyboards are the keyboards distributed with the Sun-lOOu workstation. 
Sun-1 keyboards only have function keys on the right side of the keyboard. 

Once you find out what kind of keyboard you have, and you choose which side of 
the keyboard to put the function keys on, you can specify this choice to the sys- 
tem using setkeys. The following table shows what to put in your .login 
file to set up your function keys. 



Table 8-1 Setting Up Your Function Keys 



Note: When you type lefty as an 
argument to setkeys, 






acts just like I CtftL) . 
but saves a lot of finger-stretching 
because it’s closer to the function 
keys on the right side of the key- 
board. 



Keyboard 

Type 


Keyboard 

Side 


Typical 

Handedness 


Text in 
. login File 


Sun-1 


Right only 


Left or Right 


setkeys sunl 


Sun-2 


Left 


Right 


setkeys sun2 (Defaul 


Sun-2 


Right 


Left 


setkeys sun2 lefty 


Sun-3 


Left 


Right 


setkeys sun3 ( Defaul 


Sun-3 


Right 


Left 


setkeys sun3 lefty 



Note: Put the cursor over the gray 
screen background as you affix the 
labels to the keys, so you don’t exe- 
cute a text operation accidentally. 



After you have set up your function keys, affix the appropriately sized and 
marked labels, located within the back cover of this document, over the indicated 
keys for your keyboard type. 



#sun 

Nr microsystems 




Chapter 8 — Editing and the Text Facility 67 



Figure 8-1 Affix Labels on Left or Right of Sun-2 Keyboard 
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The even-numbered keys between [ LI 1 and IL101 are thinner on the Sun-3 key- 
board than on the Sun-2 keyboard, so use the thin labels for those function keys. 

Sun-3 keyboards also have a pre-labeled I Caps Lock! key, but the I Pi I keys acts 
as a ( Caps Lock 1 key for individual windows. You probably want to affix the 
( Caps Lock 1 label on the t FI 1 key anyway. 



Figure 8-2 Affix Labels on Left or Right of Sun-3 Keyboard 



Either LI -L10 



Stop 


Again 


Props 


Undo 


Expose 


Put 


Open 


Get 


Find 


Delete 



Sun-3 Keyboard 



Caps 

Lock 



FI Key 



or R1 - RJ5 



Again 




Stop 


Undo 




Props 


Put 




Expose 


Get 




Open 


Delete 




Find 



Labels on Left 
Mouse on Right 



Labels on Right 
Mouse on Left 



{must type: 
setkeys 



lefty) 
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The Sun-1 keyboard only supports text facility function keys on the right side of 
the keyboard; there are no keys on the left side. Because there is a predefined 
1 Cans Lock! key on the Sun-1 keyboard and no [ FI I key to act as an additional 
I Cans Lock 1 . you don’t need the [ Ca ps Lock 1 label for the Sun-1 keyboard. 

I Stop 1 . however, appears on the left side, so affix the I Stop 1 label on the 
[SETUP] key. 

Figure 8-3 Affix Labels on Right Side of Sun-1 Keyboard 




Set Up Key 



Sun-1 Keyboard 

PF1 - PF4, etc. 




Right side of keyboard ( must type: 

for left- and right-handed people set keys sunl) 



To find out more about the arrow keys, resetting the function key set up, and 
set key s in general, see the set keys Man Page, online or in the Commands 
Reference Manual. If necessary, you should be able to remove and restick the 
labels on new function keys without damaging the labels or the keyboard. 

If you have a problem with arrow keys or function keys, such as the: 

.ttyswrc error: keyname cannot be mapped. 

notification when starting up a subwindow, try looking in the chapter about 
modifying subwindow behavior, Chapter 16 . 
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So far, you have probably used only old-style menus and stacking menus. The 
frame and root menus appear in the old style unless you specify otherwise with 
defaults edit as discussed at the end of this section. In the description of 
perfmeter (Section 7.3 ), you learned about stacking menus. 

Walking menus are similar to stacking menus, but you can more easily pick hid- 
den menu items with walking menus. A walking menu looks like an old-style 
menu, except that some menu items have an arrow that points to the right (=>). 
You can move the mouse through these arrows to make a hidden pull-right menu 
appear, so you can pick additional menu items. 

Figure 8-4 Typical Walking Menu (for texteditj 



8.2. New-Style Menus, or 
Walking Menus 



♦ 




irectory: /usr/athena/un ld/test 



Save =* 

Load file 
Select line # 
Split view 

Destroy vies 

Reset 

What line #? 
Get froa file 
Caret to top 
Li ne break * 
Set directory 
Find * 



Step-by-step instructions for choosing hidden menu items on the pull-right por- 
tions of walking menus at the end of the section on basic editing with tex- 
tedit (Section 8.3 ). 

Since new-style walking menus are generally easier to use than the old-style 
menus, you should probably switch to the walking menu style using 
def aultsedit in category SunView to set the attribute Walking_Menus 
to Enabled . 21 

8 3. Basic Editing This section explains briefly how to edit text in text subwindows, including these 

operations on text: 

□ insert 

□ delete 



21 See the section on defaultsedit (Section 11.1 ). 
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□ copy 

□ move 

□ replace 

In addition, you learn how to load and save a file with the text editor tex- 
tedit. The next chapter (Chapter 9 ) describes more advanced editing tech- 
niques. 



Terminology 



Learning the following terms makes it easier to read the rest of this manual: 



1 LEFT ) 
(MIDDLE) 
(RIGHT) 
cursor 

point at 

click 

select 



Left button on mouse. 

Middle button on mouse. 

Right button on mouse. 

The distinctive shape, usually an arrow pointing 
“north-west,” that follows and indicates the position of 
the mouse. 

Position the cursor over. 

Press and release a mouse button. 

Indicate a span (a contiguous sequence) of characters by 
moving the cursor and clicking. 



Note: Inverse video means reversed selection 

light and dark portions of the 

screen. 

primary selection 



adjusting a selection 



insertion point 
caret 



A span of characters, highlighted by inverse video, 
underlining, or gray shading. 

Or current selection, span of text highlighted by inverse 
video, and marking the area for current editing opera- 
tions. 

Moving the cursor and clicking to make a selection 
encompass more or fewer characters. 

The place where the next character you insert will go. 

A blinking triangular, gray diamond, or rectangular solid 
or outline shape that indicates the insertion point. 



Note: Within the text facility, ( DeLi . 
the delete characte r key, is c om- 
pletely different from I Delete 1 . the 
delete function key. 



shelf 



scrolling 



scroll bar 
scroll button 



A place where the text facility stores the text you select 
or delete, using the I Put) or 1 Delete 1 function keys. 

Moving the text up or down in a sub window; can also 
think of it as repositioning the subwindow with respect 
to the data it displays. 

A gray column at the left of the text subwindow used for 
scrolling and indicating position within the entire text 

The box at the top or bottom of the scroll bar used for 
scrolling. 
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menu A list of operations that you can choose by pressing and 

holding ( RIGHT 1 and moving the cursor. Menus appear 
when, and for as long as, you hold down [ RIGHT 1 . The 
operation occurs when you release I RIGHT 1 with the 
cursor over a menu item. 



menu item 



root menu 



frame menu 



The area of a menu that you pick using the mouse to 
invoke a particular operation. 

The menu you obtain by holding down I RIGHT 1 with 
the cursor over the gray background area of the screen. 

The menu you obtain by holding down I RIGHT 1 over 
the border or namestripe of any window. Contains the 
operations Close, Move, Resize, Expose, 
Hide, Redisplay, and Quit. 



text subwindow A subwindow that provides display and editing capabil- 

ity for text. 

command subwindow A text subwindow that includes a command interpreter, 

like cmdtool. 



tty subwindow A subwindow with a command interpreter that doesn’t 

support some of the text facility editing operations, like 
shelltool. 

text menu The menu you obtain by holding down ( RIGHT 1 any- 

where inside a text subwindow. Contains operations 
such as Save, Load File, Reset, and Find. 



Starting textedit To edit or examine a file, pop up a root menu and choose the TextEdit or 

item to start up a textedit text subwindow. After a moment, the tex- 
tedit appears on your screen. 22 



22 If you have your own root menu, see Chapter 15 on modifying root menus, you may want to add to it a 
line which invokes textedit. 
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Figure 8-5 Starting text edit With the TextEditor Root Menu Item 



Suntools j 


S2[2IIEE»H 




'tiEUUSUHHi 


ItextEditor 


0efau1tsEditor| 




ObxTool 


PerfMeter 


j-jjjQQimUQH ' 


Console 


Lock Screen 


Redisplay fill 






As an alternative to selecting the TextEditor root menu item, you can type 
textedit , followed by the ampersand character (&) for background process- 
ing, to a shelltool command prompt. 

Figure 8-6 Starting textedit From shelltool Command Prompt 



venus % textedit & 

venus % 

s, > 



Loading the Initial File 

Note: Whenever the text subwin- 
dow is empty, you can type 
filename in it and press I ESC I to 
load a file. An empty text subwin- 
dow displays File: (NONE) in its 
namestripe; select the Reset text 
menu item once or twice to make 
any text subwindow empty. 



Move the cursor into the textedit window and type the filename of the file 
you wish to edit, followed by [ E$Cl . 

Choose a file that you don’t mind damaging while you experiment with the text 
editor. One possibility is to copy your . login to a file called junk (using 
the cp command in a shelltool), then load junk into textedit — 
you can remove junk when you’re finished experimenting with textedit. 
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Figure 8-7 Loading the Initial File into t extedit: Before 



Note: When the text edit win- 
dow is iconic, the icon displays the 
name of the file currently loaded in 

textedit. 




Figure 8-8 Loading the Initial File into textedit: After 




When you start textedit from the command line in a shelltool, 
textedit ’s working directory starts as the current directory of the 
shelltool. 

But when you create a textedit window using the root menu, text edit’s 
working directory is the directory from which you started suntools, most 
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Selecting Text 
Selecting a Character 

Figure 8-9 



Selecting a Span of Characters 



often your home directory. 

For information about changing directories, see the section on changing direc- 
tories later in this chapter. 



You need to know how to specify text selections as operands for text menu edit- 
ing operations, like loading a file and storing to a file. Text selections also act as 
operands for function key editing operations, such as delete and find. So you 
need to leam how to select portions of text efficiently. 



Select a single character by moving the cursor over die character and clicking 
1 Lfc.Fl I . text edit highlights the selected character using inverse video. 



Selecting a Character 
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67 -Ws 
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790 -WP 


640 


0 
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164 -Ws 


570 


427 -WP 


64 


0 



Alternatively, you can hold down f LEFT 1 and move the cursor to the correct 
place before releasing the mouse button. 



Select a span of characters by selecting the the first or last character (click 
1 Leu 1 over it), then adjust the selection by pointing at the other endpoint and 
clicking f MIDDLE 1 . 
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You can also hold I MIDDLE! down and move the endpoint to a new position 
before releasing the mouse button. 



Figure 8-11 Adjusting a Selection 




You can adjust a selection as many times as you like, and you can adjust either 
end of the selection; you adjust the end of the selection closest to the cursor when 
you press [ MIDDLE I . You can make a selection larger or smaller when adjust- 
ing it. 
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For more advanced selection techniques, see the chapter on advanced editing, 
Chapter 9 . 



Insertion Point When you click the left or middle button on the mouse, you actually do two 

things: 

□ Select a character or characters 

a Specify the insertion point. 

Note: As soon as you edit the text 
in a textedit text subwindow, 
the character string (edited) 
appears after the filename in the 
namestripe. textedit, while 
iconic, displays a greater than sym 
bol (>) in front of the filename that 
you’ve edited, but not yet saved. 



Figure 8-12 Typing Text at the Insertion Point 



le: junk (edited); directory: /usr/athena/ui ld/test 



[ + (Scratch area... || 


|^| CHdtOOl 


-«P 


0“ 


0 -Us 570 67 -UP 


0 


0 -U1 ' 


« CONSOLE -UL consol 


hh e C 

H clock 


-0p 


568 


0 -0s 192 31 -0P 


572 


0 -01 




H textedit 


-Kp 


receptive 283 165 -He 581 


576 


-UP 708 


0 -01 


■ B&1 ItOOl 


-Up 


T568 


66 -0s 584 555 -0P 


776 


0 -01 




■ shel ltool 


-Up 


106 


67 -0s 638 790 -0P 


610 


0 




M shel ltool 


-Up 


126 161 -8s 570 427 -UP 


64 


0 








The insertion point is the place where the next character you insert will go. 

Try clicking [ LEFT1 at some spot in the file to set the insertion point, then type 
in some text 



Whenever you click the mouse in a text subwindow, you highlight one or more 
characters in inverse video and the caret , a blinking triangle, appears at the end 
of the selection closest to where the cursor was. 

For example, to place the insertion point between letters p and t in character 
string receptive, position the cursor between pand t (actually anywhere 
between the middle of p and the middle of t will do) and click I LEFT! . 
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Figure 8-13 



Basic Editing Operations 



Deleting the Character to the 
Left of the Caret 



Moving the Insertion Point 




Besides moving the insertion point, you select the character closest to where you 
placed the cursor, in this case p or t. But in the above example, the user 
clicked slightly closer to the left side of the insertion point, selecting p. 

The insertion point is always between characters, eliminating the need to specify 
whether you are inserting before or appending after a particular character. 



Summing up insertion of text — to insert characters in a text subwindow, simply 
place the caret where you want the characters to go and start typing. There is no 
insert command; unlike vi, the editor is modeless. 



You can delete the character immediately to the left of the caret using your nor- 
mal UNIX rubout character ( [ DELI , the delete key, or 1 BACKSPACE 1 for most 
users). 
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Figure 8-14 Deleting the Character to the Left of the Caret 




Deleting the Character to the You can also delete the character immediately to the right of the caret by holding 

Right of the Caret the 1 shift i key down and typing the rubout character. This ability to reverse 

the direction of the delete illustrates the general ‘ ‘toggling’ ’ property of the 
I SHIFT 1 key, especially when used in conjunction with text facility function 
keys. 

Figure 8-15 Deleting the Character to the Right of the Caret 
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Note that it doesn’t matter whether you typed the character as part of this inser- 
tion, or it was already there from before this editing session, you can still delete 
it 



When you delete a newline character, you join the two lines into one. 



Figure 8-16 Deleting a Line Break 
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Deleting Words 



Use your UNIX word erase character (usually ( CTRL-Wl I to delete the previous 
word. 
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Figure 8-17 Deleting a Word 




As with the rubout character, f SHIFT 1 toggles the direction of the delete, delet- 
ing the next word to the right of the caret, instead of to the left. 



Deleting Lines 



Figure 8-18 Deleting a Line 




As with the rubout character, ( SHIFT ) toggles the direction of the delete, delet- 
ing the rest of the line, rather than the previous line. 
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Deleting with a Function Key 



Another way to delete a character or characters is to select them, then press the 
I Delete I function key (usually f LlO 0 . 



Figure 8-19 




Figure 8-20 



Deleting the Selection with a Function Key 




You can type 1 CTRL-D I , instead of I Delete 1 , if you find that easier. 



Reinserting Text Deleted with a 
Function Key 



You can use the f Get] function key (usually ( L8 1 ). or [CTRL-GJ , to reinsert the 
last selection that you deleted (from any text subwindow) at the caret. 
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Figure 8-21 Reinserting the Deleted Selection 




Whenever you delete a selection, the text facility stores it on the shelf, like stor- 
ing some jam on a shelf in your kitchen for later use. 

1 Getl copies the contents of the shelf to the insertion point. 

Moving a Selection To move a selection from one location to another in the same text subwindow, or 

between different text subwindows: 

□ Make the selection, 
o Press ( Delete 1 . 

□ Select the new insertion point, 

o Press ( Get ) . 

Copying a Selection The 1 Put 1 function key (usually Q2D) stores selected characters on the shelf 

without deleting them. Thus, you can copy characters from one place to another 
by selecting them. 
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Figure 8-22 Selecting Text to Be Copied 




Then press [Put] . Select the new insertion point, and press 1 Get) to copy from 
the shelf to the insertion point on the screen. 



Figure 8-23 Copying the Text Selection 




Replacing Text Selections To replace a text selection with some other text: 

□ Select the text you wish to replace, 
a Press 1 Delete 1 . 
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More About Move, Copy, and 
Replace 



Compatibility Between 
textedit and shelltool 



Copying from One Window to 
Another 



Figure 8-24 



a Insert the new characters, since the insertion point is in the place where the 
deleted characters were. 



You can perform all variations of copy, replace, and move using the I Delete 1 . 
[Put! and ! Get 1 . 

You’ll learn more efficient, but more complicated, ways to do moves, copies, 
replaces, and exchanges in the chapter on advanced editing (Chapter 9 ). 



You can use f Get 1 and f Put 1 the same in shel It oo Is, as in text subwindows 
( ( Delete 1 and the other functions keys don’t function in a shelltool since 
shelltools don’t support editing). 



You can copy a selection from one window (of any type supported by the text 
facility, including cmdtool and textedit) to another window using the 
same mechanism you used to copy a selection from one spot to another within a 
single window: 

□ Make the selection in one window. 

□ Press ( Putl . 

□ Select the insertion point in the other window. 

□ Press 1 Get 1 . 



Making a Selection in One Window 
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Figure 8-25 



Undoing Editing Operations 



Note: Each window keeps its own 
[ Undo ) information, unlike the shelf 
which all of the windows share. 
Currently, there is no way to 
I Undo 1 an [Undo) . 



Scrolling Text 

Note: This material about scrolling 
text subwindows applies to all 
subwindows that support scrolling 
(have scrollbars) that you’ll 
encounter in this manual and in 
other SunView manuals. 



Copying the Selection into the Other Window 
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Another useful operation is I Undo I (usually I L4 1 ). When you press I Undo! , you 
undo all of the edits you have made in the current text subwindow since the last 
time that you made a selection, or typed I Get) . I Putl . or I Delete) . 

Another I Undo ) undoes the changes you made back through the time interval 
since the previous insertion point change. This I Undo 1 behavior continues back 
in time by changed insertion point intervals up to the limit specified when you 
created the text subwindow (the default value is 50 intervals). 



Sometimes, the text you’re editing is too large to be entirely visible within a text 
subwindow. In many cases, you can resize the window, but most often you prob- 
ably want to scroll the text through the window. Think of the window as a 
porthole permitting you to access part of a larger mass of text. To access other 
parts of the text, you have to move the text relative to the window. 

At the left of each text subwindow is a gray column called the scrollbar, which 
contains a darker gray area called the bubble. The bubble indicates the relative 
size and location of that portion of the document that is currently visible. For 
example, if the bubble is about one fourth the size of the scrollbar, the document 
is about four windows in length. 
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Figure 8-26 The Scrollbar and Scroll Bubble 
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At the top and bottom of the scrollbar, you can see a square that contains 
up/down arrows. These squares are scroll buttons. 

Both scroll buttons operate the same way; the bottom button is a convenience 
when you don’t want to move the cursor all the way to the top of the window 
when you’re editing near the bottom. 



Scrolling Forward — Text 
Moves Up 



To scroll the display forward one line — text in window moves up — click 
(LEFT! in the scroll button. 



Scrolling Backward — Text 
Moves Down 



To scroll the display backward one line — contents of window moves down — 
click (EIGHT) . 



Scrolling a Page at a Time You can scroll forward a page at a time, an amount equal to the height of the 

subwindow, by clicking \ MIDDLE 1 in the scroll button, or scroll backward a 
page by clicking ( MIDDLE 1 while holding down f SHIFT ) . 

Some more advanced scrolling techniques appear in the chapter on advanced 
editing (Chapter 9 ). 

Saving Your Work Save your work often when editing a file, because if the system crashes, you’ll 

lose the work you’ve completed. 
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Saving Your Editing to the When you’re ready to save your file editing work, pop up the text menu, and 

Current Filename choose the Save menu item. This saves your work in the current filename asso- 

ciated with the text subwindow. 



Figure 8-27 Saving Your Editing Work to the Current Filename 



Note: When you’re editing a file in 
a textedit text subwindow, the 
name of the file you are currently 
editing, if any, and the current work- 
ing directory appear in the names- 
tripe at the top of the window. 
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textedit ’s Backup Files textedit copies the original contents of the file, as of the last save or store, to 

a filename with the same name, except that it affixes a percent sign (%) to the end 
of it. textedit locates this backup file in the current directory at the time it 
copies the file. 

These “%” files don’t go away unless you delete them; but textedit 
overwrites them each time you save the file to the original filename. You can 
Save a file more than once and continue editing. 

Storing Your Editing Work to To store your editing work to an existing or new file of your choice, use the 

Another Filename Store to named file menu item. Follow these steps: 

□ Select the filename where you wish to save your editing work from any win- 
dow on the screen. Specify the absolute or relative pathname of the file 
when you don’t want to store to a file in the current directory. 

□ Pop up the text menu and hold down f RIGHT] . 

□ Move the cursor into the Save menu item area. 

□ Move the cursor toward and through the arrow (=>) just to the right of the 
menu item on the walking menu to obtain a pull-right menu. 
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Figure 8-28 



8.4. Intermediate Editing 



The Scratch Text Subwindow 



□ Move the cursor to choose the Store to named file item in the 
pull-right menu. 

□ Release [RIGHT! . 



Saving Your Editing Work to Another Filename 
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A menu that has pull-right menus accessible through a right arrow (=>) is a 
walking menu, described in the earlier section on walking menus (section 8.2 ). 

You’ve finished the section on basic editing with the text facility and you deserve 
a break if you want one. 



This section adds a few details to the basic editing that you learned in the last 
section. 



The scratch text subwindow, or ‘ ‘scratch area,” is a text subwindow at the top of 
the text edit window in which you can type whatever you want without mix- 
ing it into the file you are editing. 23 So, when you want to select a filename, 
directory name, or whatever else: 

□ Move the cursor into the scratch text subwindow. 

□ Type the span of characters you want to select. 

□ Select the desired span of characters. 



23 You can specify the size of the scratch text subwindow using def aultsedit. For more information, 
see the section on defaultsedit. Section 11.1 . 
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Figure 8-29 Moving the Cursor into the Scratch Text Subwindow 



Note: As an alternative, you can 
change the working directory of a 
textedit that has an empty pri- 
mary subwindow in a way similar to 
the method for loading a file into an 
empty text subwindow described 
earlier — type the directory name in 
the tex t subwindow, followed by 
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You select the text just as you did in the primary subwindow, by clicking 
f t.f.ft I over one end of the span and ( MIDDLE 1 to adjust the selection to the 
other end of the span. 



Figure 8-30 Selecting Within the Scratch Text Subwindow 



T" "0 -WV "”ONSOLE -WL consoT 



-Vp 283 185 -Us 584 576 -VP 708 

-V p 568 66 -Vs 584 555 -VP 776 

I shelltool -Vp 106 67 -Vs 638 790 -VP 640 

textedit -Vp 283 165 -Vs 584 576 -VP 708 

s 570 427 -VP receive -VP 6 



0 -VI 
0 -Vi 
0 

0 -Vi shelltool -Vp 126 164 -V 



- 1 le: recei ve 
Scratch 



Srea 



directory: /usr/athena/wi ld/test 



cmdtoo 1 














-WL console -C 












clock 


-Wp 


568 


0 -Vs 


192 31 -VP 


572 


0 -Vi 


textedit 


receive -Vp 283 165 -Vs 584 576 -VP 


708 


■ai Itool 


-Vp 


568 


66 -Vs 


584 555 -VP 


776 


0 -VI 


shelltool 


-Vp 


106 


67 -Vs 


638 790 -VP 


640 


0 


shelltool 


-Vp 


126 


164 -Vs 


570 427 -VP 


64 


0 



sun 

microsystems 



Chapter 8 — Editing and the Text Facility 9 1 



Changing the Working You can change the working directory of text edit at any time by choosing 

Directory with the Text Menu the Set Directory item on the text menu. The current working directory of 

the text edit appears in the namestripe, along with the name of die file you’re 
editing. Basically you need to follow these steps: 

□ Select the directory name from any of the text subwindows or 
shelltools on your screen; if the directory name doesn’t occur on the 
screen, you can type it in the scratch area and select it. 

□ Move the cursor into the text subwindow. 

□ Pop up the text menu by pressing and holding down 1 RIGHT 1 . 

□ Choose the Set Directory menu item by moving the cursor over that 
item and releasing ( RIGHT 1 . 



Figure 8-31 Selecting the Set Directory Item on the Text Menu 




The namestripe notifies you of the directory change from the directory 
/usr/athena/wild/test to the directory /usr/athena/wild. 
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Figure 8-32 text edit Namestripe after Directory Change 
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Loading a File with the Text 
Menu 



To load a file with the text menu: 

□ Select the filename from any of the text subwindows or shelltoolson 
your screen; if the filename doesn’t occur on the screen, you can type it in 
the scratch text subwindow and select it. 

□ Move the cursor into the primary text edit subwindow. 

□ Pop up the text menu and choose the Load f ile item. 
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Here is the illustrated description — select a filename, for example units. 



Figure 8-33 Selecting a Filename 
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Pop up the text menu and choose the Load file item. 



Figure 8-34 Choosing the Load file Text Menu Item 
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The textedit namestripe notifies you of the loaded filename, similar to the 
way it notifies you of directory changes. 
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Figure 8-35 



Clearing the Text Subwindow 
with reset 



Creating a File from Scratch 



Leaving the Editor 



8.5. Summary of Basic and 
Intermediate Editing 



textedit Namestripe after Loading File 




You can clear the text subwindow by choosing the Reset text menu item. 

This makes it possible to load a file by typing the filename, or to set the directory 
by typing the directory name in the text subwindow, followed by (ESC1 . as 
described above. 



If you want to create a new file from scratch, you can simply start inserting and 
editing text into an empty text subwindow. When you are finished, you can store 
the result on any file you like as described in the subsection on saving your work 
at the end of the section about basic editing (section 8.3 ). In other words, you 
don’t have to start out by editing an existing file. 



Use the Quit menu item on the frame menu. The editor will not allow you to 
quit if you have made edits and not saved them. You can Reset when you 
want to quit without saving your work. 



Select 


1 LEFT ) to select. [ MIDDLE 1 to adiust. 


Scroll 


1 LEFT 1 in scroll button to scroll forward one line. 
[ RIGHT ] to scroll backward. ( MIDDLE 1 to scroll 




a page. 


Insert 


Type characters. 


Delete 


I Delete) function kev or [ CTRL-D 1. With char- 
acters adjacent to the caret, you can use UNIX 
rubout, erase word, or line kill characters. 
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Reinsert deleted text 


IGetl or [ CTRL-G 1. 


Replace 


1 Delete 1. tvoe characters. 


Move 
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rpim. 
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f Undo 1 function kev. Undoes all edits since last 
time insertion point changed. 


Load a file 
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Save 
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Advanced Editing 



The previous chapter presented beginning and intermediate text facility opera- 
tions and features. This chapter presents more advanced features which allow 
you to perform these and other operations more efficiently and succinctly. 

Learning more about the text menu will assist you in the advanced editing sec- 
tion that follows. 



9.1. More About the Text The Text Menu contains the following items: Save, Load file, Select 

Menu line #, Split view, Destroy view, Reset, What line #?, 

Get from file. Caret to top, Line break, Set Directory, 
Find, Put then Get, and Edit On/Off. 

Some of these menu items are obscured in gray, meaning that you can’t use them 
because they are inactive. For example, Destroy view only appears when 
there is more than one view — it doesn’t make sense to destroy a view when 
there is only one view in the window. 

Some menu items have => to their right, indicating that you can use them to 
pick hidden menu items on a pull-right menu (see the section on walking menus, 
Section 8.2 ). 



Note: When using textedit, you Save => 
can see the name of the current file 
and the current directory in the 
namestripe. 



Save the contents of the text subwindow to the 
current filename. You can bring up a pull-right 
menu to pick these hidden items: Save file, 
Save & Quit, Save & Reset, Close & 
Save, Store to named file, Store & 
Quit, and Close & Store. Save file 
on the pull-right works the same way as the 
Save item on the original text menu. Store 
to named file allows you to store the con- 
tents of the text subwindow to a file other than the 
current one. Specify the name of file to which 
you want to store with the current selection, using 
either the absolute or relative pathname. If the 
indicated file already exists, the text facility asks 
you to confirm the operation. After storing, this 
file becomes the current file. Save writes to the 
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Note: As explained before, another 
way to load a file is to type into an 
empty text subwindow — names- 
tripe displays File: (none) — 
the name of the file terminated by 

CEESD. 



Load file 



Select line # 



Split view 



Destroy view 
Reset 

What line #? 
Get from file 

Caret to top 
Line break => 



new current file until you change it once again. 
The remaining four items are accelerators for per- 
forming two operations with a single action. 

Specify the name of the file you want to load with 
the current selection. If you’ve made any edits, 
the text facility asks you to confirm the operation. 

Treats current selection as a line number. Moves 
the caret to corresponding line and, if necessary, 
scrolls the text subwindow so that the line is visi- 
ble. Useful to track down errors caught by a com- 
piler. 

Split a text subwindow into two subwindows. 

The text facility asks you to specify the boundary 
between the sub windows. You can scroll the two 
subwindows independently. However, they view 
the same document, and share a common primary 
and secondary selection and insertion point; the 
edits and selections you make in one subwindow 
are reflected in the other. You can split the 
subwindows again, and resize them the same way 
you resize any other subwindow. In other words, 
press 

I CTRL-MIDDLE I on the subwindow boundary 
and adjust the boundary to where you want it 

Destroy one of the views. Active only when more 
than one subwindow views the document 

Clear the text subwindow when you haven’t made 
any edits. Otherwise, the text facility asks for 
confirmation, discarding all edits and returning to 
the state as of the last Save or Store, upon 
receipt of your confirmation. 

Display the line number of the (start of) the 
current selection. Useful in conjunction with 
dbx. 

Insert, at the caret, the contents of file named by 
the primary selection. If the primary selection is 
pending-delete, replace it with the contents of the 
file. 

Reposition the text subwindow so that the line 
containing the caret is at the top of the window. 
Useful when the caret is not visible. 

Normally the editor wraps long lines (see the sec- 
tion on wrapping long lines, Section 9.5 ). This 
menu item allows the user to switch from 
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Set directory 



Find => 



Put then Get 



Edit On/Off 



wrapping to clipping long lines or, when you pick 
from the pull-right menu, specifies Clip 
lines and Wrap lines explicitly. Only one 
of these pull-right items is active at a time; the 
other is obscured in gray. 

Set the working directory to the primary selection. 
Similar to the cd command typed to a shell 
whose current directory is the editor’s current 
directory. The primary selection must specify an 
absolute or relative pathname. 

Search for the primary selection, or for the con- 
tents of the shelf when there is no primary selec- 
tion. Find has four hidden items: Find, 
forward, the default, Find, backward, to 
search in reverse, Find shelf, forward, 
to search explicitly for the contents of the shelf, 
and Find shelf, backward, to search in 
reverse for the contents of the shelf. 

Copies the current selection to the insertion point. 
When there is no current selection, Put then 
is obscured in gray, so as to perform only the 
Get operation, copying the contents of the shelf, 
if any, to the insertion point 

Permits (Edit On), or disallows (Edit Of f ), 
text facility modifications behind the read-only 
boundary of command subwindows. When 
you’ve chosen Edit On, you can’t alter your 
command prompt or command history. Opera- 
tions that don’t modify the command prompt or 
command history still function with Edit On. 



9 2 . Advanced Editing This section describes in detail: 

□ Advanced selecting 

□ Advanced scrolling 

□ Splitting views 

□ Advanced editing operations 

□ Searching for character spans with [ Find 1 

□ Repeating operations with ( Again 1 

□ Editing in tty subwindows (shelltool) 

□ Editing in command subwindows (cmdtool) 

□ Mousing ahead 
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Terminology 



Note: A primary pending-delete 
selection is obscured by a darker 
gray than a secondary pending- 
delete selection. 



Advanced Selecting 



Level of Selection 



□ Wrapping long lines 

□ The necessity of saving your editing work 

□ Filters and extensibility 

□ Various text options 

But first some new terminology. 



Here are some additional text selection terms you will need to know. 



Multi-Clicking Pressing a mouse key more than once in quick 

succession at the same location. You can set the 
maximum time between lifting up a key and 
pressing down the next key within a multi- 
clicking operation using defaults edit; the 
default interval is 0.39 seconds. You can set the 
maximum distance of movement between clicks 
using default sedit as well; the default dis- 
tance is 3 pixels. 

Secondary Selection A selection you make while holding down a func- 

tion key. The selection, indicated by underlining 
the selecting characters when using I Put 1 or 
( Find! , and by obscuring in gray when using 
I Delete 1 . lasts only as long as you hold down the 
function key. When you release the function key, 
it operates on the temporarily selected characters, 
rather than on the primary selection. 

Pending-Delete Selection A selection, either primary or secondary, you 

make while holding down the I CTRL) key. You 
automatically delete pending-delete selections 
with a subsequent insertion or copy. Pending- 
delete selections are obscured in gray. 



These selection techniques expand on the beginning selecting techniques 
described in the last chapter. 



Each selection has a level, referring to the units that compose the selection. 
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For example, you could select the previous sentence as a span of 79 characters, 
13 words, or one line. By default, you make selections at the character level. 
However, you can specify higher levels of selection, for example words or lines, 
by multi-clicking. You can select a word by pointing at any character in that 
word and double-clicking [ LEFT ) . The main attraction of word selection is 
speed and convenience; you don’t have to select carefully the first and last char- 
acters in the word. To select an entire line, point anywhere within the line and 
triple-click. 

When you make a selection by multi-clicking, the caret appears at the end of the 
word closest to where the cursor was. For example, when you place the cursor 
anywhere to the left of the letter u in the word petunia, and double click, the 
caret will appear in front of the letter p. 

Figure 9- 1 Example of Multi-Clicking To Select a Word 




Using multi-clicking, you can easily position the caret before or after a word, or 
at the beginning of a line. 

You can adjust a selection in units of its current level. When you select a word 
by double-clicking, then extend the selection, the selection consists of a sequence 
of words, regardless of where you position the mouse. 




Note: A word, is a sequence of one or 
more alphanumeric characters begin- 
ning and ending in any non- 
alphanumeric character. 
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For example, to select in the previous sentence the span of characters that begins 
with the word selection and ends with the word regardless, point any- 
where in the word selection, double-click I LEFT) , then point anywhere in 
the word regardless, and click [ MIDDLE 1 . 

Figure 9-2 Adjusting a Selection at a Higher Level 




This method provides a very efficient method for selecting a span of words or 
lines. 



Secondary Selections A secondary selection is a selection you make while holding down a function 

key. The function key operates on the secondary selection when you release it. 

Secondary selections, indicated by underlining, only last as long as you hold 
down a function key. During that time, you can adjust a secondary selection the 
same way you adjust a primary selection. 

You can also scroll while making a secondary selection, as long as you continue 
to hold the function key down. That way, you can adjust the selection to encom- 
pass characters that aren’t visible in the current subwindow. 



Note: When you want to copy text 
from another window to the editing 
window, you must press the ( Get) 
key in the editing window before you 
move the mouse from that window, 
otherwise you will shift attention to 
the other window and perform the 
I Get) operation there by mistake. In 
other words, the text facility per- 
forms the operation in the window 
where you first press the function 
key. 



With secondary selections, you can specify operands for editing operations that 
require both an operand and a destination, such as copy or move. Secondary 
selections provide the ability to perform an operation without disturbing the 
current primary selection and insertion point. 

You already learned one method for copying text from one place to another: 

□ Select the text 

□ Press I Put I 

□ Select the destination 
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Note: If you ever notice that a text 
subwindows gets stuck so it makes 
only secondary selections, press 
the t Stop I function key to reset the 
subwindow. 



Pending-Delete Selections 



Note: Remember that when you’ve 
used setkey s to put your function 
keys on the right side of the key- 
board, you can type the 
I LINE FEE 01 key as an alternative 
f CTRL ) key. 



□ Press 1 Get! 

A much easier way to accomplish the same operation is: 

□ Select the destination 

□ Hold down ( Getl while selecting the desired text 

□ Release f Get] 

If the caret is at the desired insertion point, then only the last two steps are neces- 
sary — simply hold down ( Getl and reach out and select the text you want to 
copy. 

You can also use secondary selections to express the operands for [ Putl and 
I Delete I , as well as for I Getl . 

For example, when you are inserting some text and you want to delete some text 
without disturbing the insertion point, simply hold the I Delete 1 key down and 
select the text you want to delete. When you release the I Delete 1 key, you delete 
the selected text, but the caret remains in its original position. 

Similarly, you can make a secondary selection while holding down the I Putl 
key, allowing you to specify where to insert the contents of the primary selection, 
instead of simply storing the primary selection on the shelf. 

In conjunction with pending-delete selections, secondary selections provide 
abbreviated methods for copy and replace, move, and move and replace. 



When you want to replace a selection immediately after you make the selection, 
pending-delete selections make your job easier. 

One frequent operation is to select some text, then type or copy its replacement. 
Pending-delete selections facilitate this more complex operation. In combination 
with secondary selections, they provide an extremely terse method for specifying 
a variety of common editing operations. 

You can specify a pending-delete selection by holding down the I CTRL I key 
while selecting or adjusting a selection. When a selection is pending-delete, any 
insertion or transfer of characters deletes the contents of the selection. 

For example, to move text from one location to another: 

□ Place the caret at the desired location 

□ Hold down both the I Getl and I Ctrl! keys 

□ Select the text 

□ Release I Getl 

When you release the ( Getl key, you insert at the caret the text you specified by 
the secondary selection. In addition, you have deleted the pending-delete secon- 
dary selection from its original location. 
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Aborting an Operation 



Advanced Scrolling 



You delete the contents of a pending-delete selection only when you insert char- 
acters subsequendy; when you make a new selection without performing any 
operation or inserting any characters, you deselect the pending-delete selection 
without deleting it 

Pending-delete selections are indicated by a gray overlay. Think of the characters 
as being less visible because they are fading away, soon to be gone altogether. 

You can change an existing selection to a pending-delete selection by holding the 
I CTRL! key down and adjusting the selection, in other words, clicking 
( MIDDLE 1 while pointing at one of its endpoints. The same character span 
becomes a pending-delete selection. 

You can remove the pending-delete status of a selection by performing the 
reverse operation: adjust the selection by pointing at one of its endpoints while 
the I CtRL I key is not held down. 



When you start an operation, for example, hold down 1 Getl and select some text, 
then decide you don’t want to complete the operation, press the I Stop 1 key (usu- 
ally (LI ) ) to abort the operation. 

I Stop I also aborts SunView operations like the frame menu items Move and 
Resize, as well as the mouse button accelerators for these operations. 

As mentioned above, if you get stuck in a mode where all your selections appear 
as secondary selections, type ( Stop ) to reset the selection service. 



You’ve learned how to scroll by lines or pages. By clicking the mouse buttons 
on the portion of the scroll bar that contains the scroll bubble, rather than the por- 
tion with the scroll buttons, you can scroll in arbitrary fractions of a page. The 
mouse buttons are the same: 

fTEFT1 

Scroll forward (display moves up) 
f RIGHT) 

Scroll backward (display moves down) 

1 MIDDLE 1 

Scroll in larger units 

However, the actual amount of scrolling depends on the position of the cursor in 
the scrollbar, as follows: 

(LEFT) 

With the cursor in the scrollbar : move the line opposite the cursor to the top 
of the window 

[ RIGHT J 

With the cursor in the scrollbar : move the line at the top of the window to 
the position of the cursor 

When you hold down ( SHIFT 1 . you scroll in the same direction as before, but 
with respect to the bottom of the window. This is especially useful when the 



4sun 

V microsystems 




Chapter 9 — Advanced Editing 107 



upper portion of a window is covered by another window. 

(SHIFT-LEFT) 

With the cursor in the scrollbar : move the line that at the bottom of the win- 
dow to be opposite the cursor 

i Shift-right i 

With the cursor in the scrollbar : move the line opposite the cursor to the 
bottom of the window 

Use ( MIDDLE") for thumbing, by analogy with what one does with a thick book 
such as a dictionary or telephone book. 

For example, when you click ( MIDDLE 1 while the cursor is one third of the way 
down from the top of the window, you scroll so that the text subwindow displays 
the portion of text one third of the way through the document. 

Moving the cursor to the top of the scroll bar (but not into the scroll button) and 
clicking [ MIDDLE 1 is a quick way to get to the beginning of the file. Similarly, 
moving the cursor to the bottom of the scroll bar and clicking f MIDDLE ) posi- 
tions the window at the end of the file. 

(MIDDLE) 

With the cursor in the scrollbar : Scroll the window proportional to position 
of cursor in scrollbar. 

Sometimes you may scroll to another part of a file by thumbing, and then want to 
return to the previous location. Just move the cursor into the scrollbar and click 
( SHIFT-MIDDLE ) . 

I SHIFT-MIDDLE ) 

With the cursor in the scrollbar. Return the window to the location before 
the last “big jump,’’ in other words, before the last thumb operation, before 
the last search that caused a scroll, or before the last I SHIFT-MIDDLE 1 of a 
scroll. 

Before each of these operations, the text facility stores the current position in the 
document, so you can return to this position with ) SHIFT-MIDDLE 1 . 



Splitting You can look at several different, possibly non-contiguous portions of the docu- 

ment you’re editing by splitting the view , or dividing the text subwindow into 
multiple subwindows. 

Choose the Split thi s view menu button on the text menu to split a text 
subwindow. 

Each view operates as an independent text subwindow with respect to scrolling, 
but all views share a single caret, primary, and secondary selection. When you 
edit one subwindow, the edits you make are reflected in all of the subwindows, 
even if you can’t see the relevant portion of the text in a particular subwindow. 

You can get rid of any view, except the original one, by picking the Destroy 
this view menu button. 
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Advanced Editing Operations 



Move, Copy, and Replace Using 
Secondary and Pending-Delete 
Selections 



Note: You may remember that a tty 
subwindow is a subwindow that 
includes a command interpreter, but 
lacks some text facility operations, 
like shelltool. 



There-To-Here 



Note: Text items on a panel, or a 
control subwindow with buttons like 
in mailtool, also support a sub- 
set of these editing operations. 



Adjust the size of the subwindows using the same method you use to move and 
resize the application: 

1 MIDDLE 1 

When cursor is over subwindow boundary : move the subwindow 

( Ctrl-middle i 

When cursor is over subwindow boundary, resize the subwindow 



These advanced editing operations permit complex manipulation of text within 
multiple text subwindows. 



The use of secondary and pending-delete selections provides a streamlined way 
of moving, copying, and replacing text 

There are eight possible move, copy, and replace operations that depend on 
whether you’re copying or moving, inserting or replacing, transferring from the 
current insertion point to somewhere else, or from somewhere else to the current 
insertion point. 

All eight operations follow the same pattern: 

□ Use pending-delete selections for moving and replacing (hold down the 
1 CTRL! key while selecting) 

□ Use standard selections for copying and inserting 

□ Use I Uet I when going there-to-here, in other words, from somewhere else to 
the caret 

□ Use I Putl when going here-to-there, in other words, from the caret to some- 
where else 

The copying method described below works for both text and tty subwindows. 
Move operations work when the destination is a text or ttysubwindow, but the 
source must be a text subwindow (because tty subwindows do not support the 
delete text operation). Conversely, for replace operations, the source can be 
either a text or tty subwindow, but the destination must be a text subwindow. 



There-to-here editing operations are the most frequent of the eight complex edit- 
ing operations. 

Copy From There to Here 
To copy text to the caret: 

□ Hold down I Getl 

□ Select the text 

□ Release I Getl 

To copy the contents of the shelf to the caret: 
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Here-To-There 



□ Press and release ( Getl 

Move From There to Here 
To move text to the caret: 

□ Hold down [ CTRL I and ( Get 1 

□ Select the text 

□ Release I CTRL1 and 1 Getl 

Copy There, Replace Here 

To copy text to replace the primary selection: 

o Make the primary selection be pending-delete, either by holding down 
[ CTRL1 while selecting it in the first place, or by holding down 
[ CTRL1 and adjusting the selection 

□ Hold down I Get) 

o Select the text to use as a replacement 

□ Release 1 Getl 

Similarly, to replace the primary selection with the contents of the shelf: 
o Make the primary selection pending-delete 

□ Press and release I Get 1 

Move From There, Replace Here 

To move characters to replace the primary selection: 

□ Make the primary selection pending-delete 

□ Hold down 1 CTRL 1 and t Get I 

□ Select the text to use as a replacement 

□ Release [ CTRL 1 and ( Get 1 

The here-to-there operations are basically the same as there-to-here, except that 
IPutl is used in place of ( Getl : 

Copy Here to There 

To copy the primary selection to another location: 

□ Make a primary selection 

□ Hold down I Put) 

□ Select the location 

□ Release I Put I 

To copy the primary selection to the shelf: 
a Make a primary selection 
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□ Press and release 1 Putl 
Move Here to There 

To move the primary selection to another location: 

□ Make the primary selection pending-delete 

□ Hold down 1 Putl 

□ Select the location 

□ Release 1 Put 1 

To move the primary selection to the shelf: 

□ Make the primary selection pending-delete 

□ Press and release [ Delete I 
Copy Here, Replace There 

To copy the primary selection to replace characters at another location: 

□ Make a primary selection. 

□ Hold down [ Putl 

□ Select the characters to replace while holding down 1 CTRL) 

□ Release 1 CTRL 1 and ( Put 1 
Move Here, Replace There 

To move the primary selection to replace characters at another location: 

□ Make the primary selection pending-delete 

□ Hold down ( CTRL 1 and t Put 1 

□ Select the characters to replace 

□ Release I CTRL 1 and I Put 1 

In each of the four here-to-there cases above, the caret stays where it is. 

Sometimes you may want to copy or move the primary selection somewhere else 
and have the caret move to the new location as well. You can do this by storing 
the primary selection on the shelf, either by pressing [Put) or (Delete) , moving 
the caret to the new location, and using ( Get) : 

Copy Here to There, Go There 

To copy the primary selection to another location and have the caret go 
along with it: 

□ Make the primary selection 

□ Press and release (‘ ‘click”) [ Put) 

□ Select the destination insertion point 

□ Click ( Getl 
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Move Here to There, Go There 

To move the primary selection to another location and move the caret with 
it: 

□ Make the primary selection 

□ Click f Delete 1 

o Select the destination insertion point 

□ Click fOiD 

Exchange Another useful operation is exchange: 

Exchange Here and There 

To exchange the primary selection with some other text: 

□ Make the primary selection pending-delete 

□ Hold down I CTRL I and ( Put 1 

□ Select the other text 

□ Release t CTRL 1 and I Put 1 

You have completed a Move Here, Replace There as described above. The 
deleted text is now on the shelf. The caret is where the primary selection 
used to be. 

o Click 1 Get) to insert the text you replaced from where you stored it on 
the shelf, thereby completing the exchange. 



Searching for Text Selections The text facility provides a 1 Find 1 operation, usually invoked by pressing the 

function key [ L9 1 . You can also use the Find text menu item. The primary 
selection is the target of the search, unless you make a secondary selection while 
holding down the I Find 1 key. 

When you haven’t made a primary or secondary selection, 1 Find 1 searches for 
the contents of the shelf. 

The search starts at the caret, skipping over the current selection, in the forward 
direction. When you want to search backwards, hold down the I shim I key 
when you press ( Find t . 1 Find 1 highlights the first match as the current primary 
selection. The caret moves to the end of the selection. 

A match occurs when the exact same characters are found; there is no regular 
expression matcher yet. 

When you reach the end of the file (or the beginning of the file, if the search is 
backwards), the search wrap arounds to the other end of the file and continues 
until it reaches its starting point. The caret stops blinking while the search is in 
progress. If no match is found, the caret will resume blinking at its original loca- 
tion. 
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The Again Operation The text facility provides an [ Again 1 operation, usually invoked by pressing the 

function kev [LSI . [ Again 1 reexecutes all of the operations that you performed 
in a particular text subwindow since the last time you changed the insertion 
point. 



Note: Scrolling the display has no 
effect on 1 Again ) . 



For example, choose an operation you want to perform at several locations in a 
document, let’s say, insert a string you’ve typed in the text sub window or stored 
on the shelf. Perform the first insertion in the usual way. Perform subsequent 
insertions by positioning the caret where you want to insert the string and press- 
ing [Again}. 

To perform the same bracketing operation in several places, let’s say, insert a 
quotation mark (") before and after each of several items, one method is to: 

□ Position the caret in front of the first item 

□ Type a quotation mark 

□ Position the caret in front of the next item 

□ Press [ Again ) 

And so on through the list Then: 

□ Position the caret after the first item 

□ Type a quotation mark 

□ Position the caret after the next item 

□ Press ( Again 1 
And so on. . . 

To accomplish this more efficiently, use the shelf to avoid changing the insertion 
point. This enables you to use [ Again 1 to repeat the combined operation of 
inserting material before and after the selected material. Here is how to do this: 

□ Select the first item 

□ [ Delete 1 to delete the item and store it on the shelf 
o Type quotation mark 

□ [ Getl to retrieve what you deleted 

□ Type quotation mark 

□ Select the second item 

□ Press I A gain 1 to repeat the previous four operations 

□ Select the third item 

□ Press f Again ) 

And so on. . , 24 



24 For frequently used brackets, you may want to bind a function key to the invocation of an appropriate 
filter, as described below in the section on filters and extensibility (section 9.7 ). 
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[ Again 1 ignores ( Undo 1 . Thus, one very convenient use of ( Again") is when you 
make an insertion at the wrong place. You simply [ Undol . select, then press 
1 Again J . 



Note: The information retained to 
enable f Again 1 is local to each text 
subwindow; edits performed in one 
text subwindow have no effect on 
the operation of I Again I in another 
text subwindow. 



You can also use I Again I in conjunction with f Find 1 to iterate through a docu- 
ment, repeating a sequence of operations at several locations. (The 1 Find 1 com- 
mand is counted as one of the operations that I Again 1 repeats, even though it 
changes the insertion point, because you did not change the insertion point.) 

For example, you can search for a particular string, then perform some operation 
at that point, such as bracketing it with quotation marks using the technique 
described above. Then press I A gain I to repeat both the search and the bracket- 
ing. (If the search fails, the rest of the operations that 1 Again I is repeating will 
not be executed.) 



Editing Tty Subwindows and As described previously, tty subwindows support a subset of the editing opera- 

Panel Text Items tions, namely those that do not involve deletions. Secondary selections and stor- 

ing the primary selection on the global shelf work the same as they do in text 
subwindows. 

Thus, you can copy characters to and from text and tty subwindows using 1 Getl 
and I Put I in the manner described above. 

Panel text items also support secondary selections and the use of I Getl . I Put I 
and I Delete 1 in the manner described above, subject to two restrictions: 

□ You can only position the caret at the end of the item 

□ You can only select the entire item 

Therefore, you can append text from a text subwindow, tty sub window, or 
another panel text item to a panel text item that has a caret by holding down 
I Get) and selecting the text you want there. 

Clicking I Getl copies the contents of the shelf to the end of the panel text item. 

Similarly, you can copy the contents of a panel text item to another panel text 
item, or to a text or tty subwindow, or to the shelf, by selecting the item and 
using 1 Put 1 as described above. 

Finally, you can type I Delete 1 to delete the contents of a panel text item and 
store it onto the shelf. 



Editing Command A command subwindow is a text subwindow that permits a dialogue with the 

Subwindows user, for example typing commands to dbxt ool, or to a UNIX command line 

in cmdtool, which is a shelltool with text facility capabilities. 

See the next chapter on the command facility, Chapter 10 , for more information. 
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93. Shift Toggles Direction of Throughout the text facility user interface, we use I SHIFT) key to mean apply 

Function the inverse or negation of a function, or to apply the function in the inverse direc- 

tion. There are currently several examples of this principle (and we expect to add 
more): I SHIFT-FimT) means search in the backwards direction. [ SHIFT 1 scroll 
means scroll with respect to the bottom of the window, rather than the top. 

I SHIFT-DEL 1 fruboutl. 1 SHIFT-CTRL-W 1 (word erase), (THIFf-CTRL-U ) (line 
kill) means delete the next character, word, or rest of line. 



9.4. Mousing Ahead You don’t have to wait for an operation to be completed before you specify the 

next one; you can mouse ahead. As you become more adept and confident with 
the text facility, you will probably start to mouse ahead more and more. 

However, since the text facility interprets a mouse click at the time the editor 
processes the click, rather than when you make the click, be aware incomplete 
operations may affect the display in the area where you want to select. 

For example, when you select a word in one line, I Delete I . then select a word in 
the next line and I Delete I before the editor has finished updating the display as a 
result of the first I Delete 1 . no problem. 

However, when you click the mouse over another word that appears later in the 
same line before the display has been updated, then you might not be selecting 
the word you intended — the first 1 Delete 1 causes everything in that line to slide 
to the left. 

So, if you want to perform a sequence of operations without waiting for the edi- 
tor to complete each one, and these operations will affect the state of the display 
in such a way as to interfere with mousing ahead, perform the operations bottom 
to top and right to left. In this way, they will not interact with each other destruc- 
tively. 



9.5. Wrapping Long Lines The default behavior for the text facility is to wrap long lines, in other words, the 

portion of a line that extends past the right edge of the window appears on the 
next line, starting at the left. 

When you don’t want wrapping of long lines, pick the Line break menu 
item on the text menu, or the Clip lines menu item on its pull-right menu. 
Then, the text subwindow clips, in other words, it doesn’t display the characters 
that do not fit on the line. 

To return to wrapping, pick the Wrap lines menu item on the pull-right 
menu. 

Deletions in a wrapped line, particularly in the vicinity of where the wrapping 
occurs, can produce display anomalies. Tabs in long lines are particularly trou- 
blesome. If the display of a line gets into a weird state, you can redisplay the 
window by picking the Redisplay frame menu item. 2 - 5 



25 You can eliminate this problem altogether by breaking long lines into shorter ones. Pipe the text through 
fmt with a filter, as described in the section on filters and extensibility (Section 9.7 ). 
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9.6. Remember to Save Your When you have been editing for a long time, the editor’s internal data structures 
Work may become sufficiently fragmented that you will notice a degradation in perfor- 

mance. Save your work, so performance will return to normal. 

Frequent saving is probably a good idea in any case since, unlike for vz, if your 
machine crashes, the edits you made since the last store or save will be lost. 



9.7. Filters and Extensibility The text facility provides the ability to pipe the primary selection to an arbitrary 

program, or filter (as stdin ), and insert the resulting output {stdout) at the caret If 
the primary selection is in pending-delete, the output from the filter will replace 
it 

For example, piping a selection through f mt will cause all of the long lines to 
be truncated to 72 characters. Piping a selection through indent will format it 
according to the defaults specified in ~ / . indent . pro (see the indent 
Man Page, online or in the Commands Reference Manual). 

You can bind a filter to an unused function key, in other words, either ( R1 1 
through I Rl4 1 , 1 FI 1 through [ F9 1 , or if you have mapped the standard editing 
operations to the function keys on the right side of the keyboard, 1 LI 1 through 

am 

To find out how to specify this binding within a file called ~ / . text swr c, see 
the chapter on modifying subwindow behavior, Chapter 16 . 



9.8. Text Options You can specify a number of options to the text facility using 

def aultsedit. 26 The most frequently used options are: 

Auto_indent With Auto_indent TRUE, whenever you 

type a newline, the white space that appears at the 
beginning of the previous line is automatically 
inserted after the newline. This only affects new- 
lines that you type , not the newlines you insert 
using the I Getl or [ Put 1 function keys. The 
default setting for Auto_indent is FALSE. 

Adjust_is_pending_delete 

With Adjust_is_pending_delete 
TRUE, whenever you adjust the primary selection, 
it automatically becomes pending-delete, in other 
words, the text facility acts as though you were 
holding down ( CTRL 1 key. The rationale behind 
this is that most of the time when you adjust a pri- 
mary selection, you want to replace or delete it 
The default setting for 

Ad just_is_pending_delete is FALSE. 



Read the section on def aultsedit, Section 11.1 . 
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Scratch window integer Integer is an integer parameter that specifies the 

height, in lines, of a scratch text subwindow for 
text edit. For example, when 
Scratch_window==2, then whenever you start 
text edit, it creates a two-line scratch text 
subwindow at the top, and a large text subwindow 
below it for editing. The default value is 1, a 
one-line scratch window. 

Edit_back_char Your delete character. Default is 1 Del 1 . 

Edit_back_word Your erase word character. Default is ( CTRL-W 1 . 

Edit_back_line Your line kill character. Default is ( CTRL-U 1 . 

Lower_cont ext Minimum number of lines to maintain between 

caret and bottom margin of a text subwindow. 
Default is 2. 



9.9. Summary of Text Facility g e [ ect 



Scroll 



Multi-Clicking 



Double [LEFT 1 selects a word; 

Triple \ LEFT 1 selects a line; 

I MIDDLE I adjusts a selection; 

[ CTRL I while selecting or adjusting for 
pending-delete. 

1 LEFT 1 in scroll bar to move corresponding line 
to top of window; 

I RIGHT 1 in scroll bar to move line at top of win- 
dow to cursor; 

I SHihT-Lfct r i in scroll bar to move line at bot- 
tom of window to cursor; 

( SHIFT-RIGHT 1 in scroll bar to move 
corresponding line to bottom of window; 

I MIDDLE ) in scroll bar to thumb; 

I SHIFT-MIDDLE 1 with cursor in scroll bar to 
return to previous location. 

To press a mouse key more than once in quick 
succession at the same location — see Select. 



Copy to caret Hold down [ Get) , make selection. 

Move to caret Hold down I Get 1 . ( CTRL ] and make selection. 

Replace at caret f CTRL) and select primary, then type or [Get] 

selection. 

Move and replace at caret I CTRL 1 and select primary, hold down [Get] . 

[ CTRL! and make selection. 

Copy primary elsewhere Hold down ( Put) , select destination. 

Move primary elsewhere 1 CTRL) and select primary, hold down [Put] , 

select destination. 
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Copy or move primary, replace elsewhere 

Select or 1 CTRL 1 and select primary, hold down 
[ Put I . ( CTRL 1 and select destination. 

Bracket a selection [ Delete 1 . insert leading text, I Getl . insert trailing 

text. 

[ Getl (Usually (S3) 

If you make secondary selection while key is 
down, copy selection to caret, otherwise copy 
shelf to caret. 

If secondary selection is pending-delete, delete it 
If primary selection is pending-delete, delete it 
and copy to shelf. 

1 Put) (Usually I L6) I 

If you make selection while key is down, copy 
primary selection to indicated place, otherwise 
copy primary selection to shelf. 

If secondary selection is pending-delete, delete it 
If primary selection is pending-delete, delete it 
and copy to shelf. 

I Delete I (Usually 1 L1Q H 

If you make selection while key is down, delete 
selected material, otherwise delete primary selec- 
tion. Deleted material is copied to shelf. 

I Find I (Usually COD) 

If you make selection while key is down, search 
for selected material. Otherwise, search for pri- 
mary selection. When no primary selection, 
search for contents of shelf. Search backwards 
when [ SHIFT 1 is down, otherwise search for- 
wards. Wrap around end, or beginning, of docu- 
ment. 

f Again I (Usually I Li H 

Reexecute all edits performed since last time you 
moved the caret. 

[ Undo 1 (Usually Q2D) Undo all edits since last time you selected, typed 

1 Getl . ( Put) , or (Delete) , or performed any opera- 
tion except (Ag^n] that uses ( Get) . 
t Put 1 . or (Delete) . Another ( Undo 1 undoes those 
edits made between that point and the previous 
( Undol . 

That completes all of the basic, intermediate, and advanced documentation on 
editing within the text facility. 
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The Command Facility 



The command facility is an extension of the text facility to provide a command 
interpreter along with the text facility functions, cmdtool is a command 
facility program that combines text editing features similar to text edit with 
a UNIX command interpreter similar to shelltool. 

dbxtool also includes a command subwindow, or subwindow based on the 
command facility. Most of the information in the next section on cmdtool 
applies to all command subwindows. 



10 . 1 . cmdtool 



Note: The cmdtool icon below 
contains a nautilus shell, referring to 
the shell, or command interpreter, 
and a scrollbar on the side, referring 
to its text facility capabilities. 



cmdtool is like shelltool with the added capability of the text facility. 
For example, you can type commands to the command prompt in cmdtool, 
just like with shelltool; also, you can scroll to previous screens of com- 
mands that you typed and search through the commands with ( Findl . iust as in 
text edit. 

To start cmdtool, pop up a root menu and choose the CommandTool item, 
or type cmdtool & to a shell command prompt. 
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Figure 10-1 cmdtool 




cmdtool icon 




You can type commands to the command prompt, or you can move around, 
select text, search for a selection, and stuff from a file, as with text edit. 

If you type: 



Is /usr/medici/text 

and then you notice that you forgot to include /doc before /text, you can 
position die caret in front of /text by pointing with the mouse and clicking, 
type /doc, then reposition the caret at die end of the line and type 
(RETURN) . 

In other words, the order in which you type the characters when composing a 
command is not what determines the characters the application receives. You 
can insert characters on and delete characters from the command line, using the 
text facility operations when you wish. 

Then, when you type 1 RETURN! , and the caret is at the end of the document, you 
send all of the characters between the start of the last command and the 
( RETURN ] to the application, in this case the command interpreter. 

The application does not see any of the characters that you type until you type 
[ RETURN 1 . at which point it receives all of the characters that comprise the com- 
mand line. 
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10.2. Command Facility This section describes characteristics of the command facility. 

Characteristics 

Read-Only Boundary By default, the command facility doesn’t permit alteration of history — there is a 

read-only boundary prior to the current command line. 

The Edit On text menu item in command subwindows permits you to remove 
the read-only boundary after starting a command subwindow. You can replace 
the boundary with Edit Off — the text menu alters itself according to 
whether or not you have a boundary. 27 

You can’t insert into, or delete from command lines that the application has 
already executed. The ( Delete 1 and t Put] function keys work only after the 
command prompt on the current command line. You can’t move the caret 
within, or prior to the current command prompt. 

The command facility notifies you that text is read-only when you attempt to 
delete it. 



Interpretation of Certain When the caret is at the end of the document, a command subwindow interprets 

Control Characters I CTRL-C 1 . 1 CTRL-D1 . and I CTRL-Z 1 the same way as when you type them to a 

shell or shelltool. 

When the caret is not at the end of the document, the command facility interprets 
two of these characters as a text subwindow would — it simply inserts any 
[ CTRL-C 1 or [ CTRL-Z 1 into the document. 

When output appears in the command subwindow while you’re typing, perhaps 
because you’ve typed ahead or you’re running a process in the background, the 
command facility inserts the output in front of what you’ve typed to prevent 
interference with the current command line. 



Moving to the Current 
Command Prompt 



When you’re scrolling through the text that includes older commands, you can 
move to the current command prompt at any time by typing I CTRL-RETURN 1 . 

1 CTRL-RETURN 1 moves you to the end of the text in textedit as well. 



vi, more, and su: Cbreak For now, the command facility doesn’t support the vi or more programs, or 
or Raw Mode man because it uses more. You can use cat instead of more because you 

have scrolling capability to look back on previous portions of the output. 

Also, a command subwindow echoes the passwords that you type in when using 
su or r login — so be careful that no one is looking when you type your pass- 
word to su or rlogin in a command subwindow. 28 



27 If you decide you don’t like the read-only boundary default, you can remove it by setting the 
Append_only_logoption to False in the Text category of defaultsedit. 

28 For information on the rlogin command, see Using the Network: Beginner's Guide. For information 
on the su command, set Doing More With unix : Beginner’s Guide. 
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The reason for these problems is that the command facility cannot yet handle 
programs with cbreak or “raw” mode. 



10.3. Summary The command facility extends the concept of a command interpreter and a text 

editor to evolve a powerful tool for command execution and editing. 

The window system also supports other editing tools, described in the next 
chapter. 
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Other Editing Tools 



Besides text edit, the Sun window system supports the editing tools 
def aultsedit, iconedit, and fontedit. You can set up your window 
system environment with def ault sedit , tailoring the window system to 
your personal needs. You can create ycur own icons for use within the window 
system using iconedit. Finally, you can design your own fonts, or typefaces, 
with fontedit. 



11 . 1 . def aultsedit def aultsedit permits you to tailor the window system and text facility to 

your preferences, for example, silencing the audible bell on your workstation if 
you desire. 

To start def ault sedit , pop up the root menu and choose the 

Def aultsEditor item, or type defaultsedit & to a command prompt. 



Figure 11-1 
Note: When you append the 

ampersand character (&) to a 
command line, you execute the 
command in the background, 
leaving the window free for typing 
other commands. 




v.yWv^y.v.y.v.y.y, 



defaultsedit icon 



defaultsedit 



defaultsedit j 


[Save] [Quit] [Reset] 






'"e "I'i'mi ill 1 1 ■ 


Get HELP by clicking the left button on the appropriate label or string 


tl Cl ick toType 


(Disabled) 


0 Disabled 


Font 


O 




Walking Menus 


(Disabled) 


0 Disabled 


Rootmenu filename 


() 




Icongravity 


(North) 


0 North 


Icon_cl osel evel 


(Ahead of all) 


0 Ahead_of_al 1 


Jump cursor on resize 


(Disabled) 


0 Disabled 


AudibleBell 


(Enabled) 


0 Enabled 


Visible Bell 


(Enabled) 


0 Enabled 


Ttysubwindou /Retained 
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To change a window system and text facility option , you must select the category 
of that option. For example, to change from old-style menus to new-style walk- 
ing menus, select the SunView category. 

Figure 1 1-2 default sedit : Selecting a Category 





||[Save] [Quit) [Reset] 


[Edit Item] || 


1 Categories: [Defaults] ("Indent] fMail] [Menu] [Scrollbar] mni^l=iwi [Text] [Tty] | 


Get HELP by clicking the left button on the appropriate label or string 




Cl ick_to_7ype 


(Disabled): ^Disabled 




Font 


(): 


* 


Walking_Menus 


(Disabled): ©Disabled 


9 


Rootmenuf i 1 enane 


(): 




Icongravity 


(North) : 0 North 


1 


Iconcl ose_l evel 


(Ahead_of_al 1 ) : © Ahead_of_al 1 


9 


Junp cursor on resize 


(Disabled): 0 Disabled 




AudibleBell 


(Enabled): ©Enabled 


9 


Visible_Bell 


(Enabled): ©Enabled 


R 


Ttysubwindow /Retained 




lid s .... , — ^ u ..... H 



Now, you can explore each of the options and associated settings by clicking the 
left mouse button on the option name to get help information, or on one of the 
settings to pick that setting. 

If you want to have walking menus, select the Enabled setting for the 
Walking_Menus option. 
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Figure 1 1-3 def ault sedit .* Selecting a Option Setting 



defaul tsedi t 



[Save] [Quit] [Reset] 



[Edit Item] 



Categories: [Defaults'] [ Indent] [Mai 1 1 [Menu j [Scrollbar] 



[ Text ] cud 



/SunV i eu/Wal kl ngMertus /Enabled 



Click _to_Type 
Font 

WalkingMenus 
Rootmenuf i 1 ename 
Icongravity 
Iconc 1 ose_ level 
Junpcu rso r_on_ res 1 ze 
AudibleBell 
Visible_Bell 
Ttysubwindou /Retained 



(Disabled) : 
(): 

(Disabled) : 
(): 
(North) : 
(Ahead_of_all ) : 
(Disabled): 
(Enabled): 
(Enabled) : 



: Disabled 

! Enabled 

\ 

! North 

! Aheadofal 1 
! Disabled 
! Enabled 
! Enabled 



Now, your menus will appear in the new style. 

def aultsedit supports several categories, including SunView, Mail, 
Scrollbar, Text, and Menu. The number of default sedit categories 
may change. 

Explore each of the categories to see the variety of option settings available to 
you. 

Some options require that you type in a setting, like Font which requires the 
filename where the font is stored. The filename for die font used to produce the 
screen illustrations in this manual is: 

/usr/ lib/ font s/f ixedwidthf ont s/ screen . r . 11 



To save the options you have set, select the Save button. Whenever you set an 
option in the SunView category, you must exit and restart sunt oo Is for the 
new setting to take effect. Only the SunView category requires exiting and 
restarting to effect option setting changes. 

To quit def ault sedit, select the Quit button. 

For more information on def aultsedit , see its Man Page, online or in the 
Commands Reference Manual. 
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11.2. iconedit iconedit is an editing tool for icons and cursors. You can create new icons or 

cursors and store them in files, or edit old icons and cursors. 

To start iconedit, choose the IconEditor item in the root menu, or type 
iconedit & to a command prompt. 



Figure 11-4 



Note: Creating and editing cursors 
is similar to creating and editing 
icons. Just remember to select 
Cursor as the setting for the 
size: option, instead of the default 
icon setting. 



iconedit 




To create an icon from scratch, select points in the large subwindow. Notice how 
all the points appear in a miniature, “actual size’’ copy of the icon in the lower 
right comer. 

Experiment by drawing points, lines, and filling rectangles or circles with various 
patterns. Invert the screen image by selecting the I invert I button, or clear die 
screen with I clear I . 
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Figure 1 1-5 iconedit Containing an Icon 




Save your work by clicking near the File : marker, inserting the filename you 
wish to store, and selecting the I save 1 button. 

To load a file, click near the File: marker, insert the filename you wish to 
load from, and select the ( load I button. 

To quit iconedit, select the I quit 1 button. 

For more information on iconedit, see its Man Page, online or in the Com- 
mands Reference Manual. 



113. fontedit 



Use fontedit to design a font, a set of characters, or to alter an existing font. 
To start fontedit, type fontedit & to a command prompt. 
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Figure 11-6 font edit 




The top subwindow is the message subwindow , where f ontedit displays 
relevant help and error messages. 



Note: Experiment with f ontedit 
on a copy of one of the standard 
font files, so that you don’t lose the 
standard font by mistake. 



Next, insert the filename of the font you want to edit after the Font name : 
marker. When you want to read in a font from that filename, select the [ Read 1 
button. You can experiment with the standard fonts for your machine, usually 
located in the /usr/lib/fonts/f ixedwidth fonts directory. 

When you want to save a font to that filename, select the 1 Save 1 button. 

Below the message subwindow is the control subwindow for setting options. 

Before you create a new font, you must set the following options: 

□ Max Width : 



□ Max Height : 

□ Caps Height 

□ X He ight — height of the letter 4 ‘x’ ’ 

□ Baseline 

Select the I Apply 1 button to enter the options into f ontedit before attempt- 
ing to create any characters. 

Next is the proof subwindow where you can type characters to see what they look 
like with the latest changes you have made. 

The series of rectangles across the middle of f ontedit allow you to select up 
to two characters for editing in the editing area below. Click on a character to 
make it appear below. 
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Click on the long rectangular scrollbar below the character selection area to 
change the series of selection rectangles to the appropriate portion of the 
alphanumeric font series. Also, you can type a character on the scrollbar, and it 
appears as the first character in the character selection area. 



Note: You can select up to two Once you select a character, f ontedit displays a magnified version and a 

aUhe^amebme 1 ^ editin9 ar0a proof version of the character in die editing area. Within the magnified version of 

the character in the editing area, you can edit the character by selecting any of a 
variety of operations listed after the Oper at ion : marker in the control 
subwindow. 

As mentioned above, you can type in the proof subwindow to check on your edits 
as you go along. 

To save individual font characters, select the [ Save 1 button next to the magnified 
version of the character in the editing area. 

To save the entire font to the filename after die Font name : marker in the 
control subwindow, select the I Save 1 button in the control subwindow. 

Exit by selecting the I Exit I button in the control sub window. 

For more information on font edit , see its Man Page, online or in the Com- 
mands Reference Manual. 



11.4. Summary 



You’ve learned the basics of all of the editing tools, freeing you to explore the 
special-purpose displays in the next chapter. 
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Special-Purpose Displays 



Some window system programs provide different types of displays, gf xtool 
divides a window in two parts; one for you to type commands, the other to view 
graphics programs, tektool is a Tektronix 4014 ™ terminal emulator , allow- 
ing you to run programs as if you are using a Tektronix 4014 terminal. 



12.1. gfxtool 



Note: You may want to start up 
gfxtool in the background of the 
parent window, so that you can con- 
tinue to type commands there. 

Type the ampersand character (&) 
after gfxtool to run it in the back- 
ground. 



To start gfxtool, choose the GraphicsTool item on the root menu, or 
type gfxtool to the command prompt of a window. After a moment, a win- 
dow with two parts, or subwindows appears. You can type commands to the 
upper sub window, just like a shelltool. The lower sub window, shaded dark 
gray, is a surface on which certain programs display graphics. 



Figure 12-1 gfxtool 




To run a graphics program with gfxtool, move the cursor into the upper 
subwindow and type the name of the program. This example shows the 
f ramedemo graphics demo. 
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Figure 12-2 gfxtool Displaying the frame demo Graphics Program 




12.2. tektool If you have used the Tektronix 4014 ™ terminal, you may want to take advantage 

of its features using your Sun Workstation. 

You can start tektool just like gfxtool. Type tektool to a window 
command prompt. Use tektool just as you would use a Tektronix 4014 ™ 
terminal. 

When a window appears, it will use the entire screen. The frame menu works as 
with any other tool. 
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Menu Accelerators 



An accelerator is an abbreviated way to perform a text facility command or 
selected other SunView operations. One common accelerator is when you open 
an icon by clicking the left mouse button on it, instead of selecting the Open 
item on the application’s frame menu. 

This chapter describes: 

□ Accelerating to the end of a text subwindow 

□ Full-length zoom accelerators 

□ Mouse button accelerators 



13.1. Accelerate to End of One important text facility accelerator is I CTRL-RETURN 1 , which moves the 

Text Subwindow caret to the end of the text in a text subwindow. This is especially useful when 

you want to get to the current command prompt in cmdtool. 



13.2. Accelerated Full-Length In addition to toggling full-length zoom of a window with the hidden Zoom 

Zoom item on a frame menu, you can hold down [ CTRL1 while typing the t Open) 

function key, in other words [ CTRL-Open 1 . as an alternative full-length zoom 
accelerator. 

The next section describes another alternative — the mouse button accelerator 
( CTRL-LEFTl on die window frame. 

13.3. Mouse Button Here is a table of mouse button accelerators, organized by function. This table 

Accelerators and a table of accelerators organized by mouse button appear in the quick refer- 

ence guide at the end of this manual. 
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Table 13-1 Menu Accelerators Organized By Function 



Desired Function 


Mouse Button Procedure 


open 


[LEFT] on icon 


expose 


( LEFT 1 on frame (border or namestripel 


hide 


[ SHIFT-LEFT 1 on frame [border or namestripel 


move 


( MIDDLE 1 on comer = unconstrained, vertical and horizontal adjust- 
ment 

[ MIDDLE 1 on middle third of edee = constrained, movement either hor- 
izontally or vertically 


resize 


[ CTRL-MIDDLE 1 on comer = unconstrained, vertical and horizontal 
adjustment 

I CTRL-MIDDLE 1 on middle third of edee = constrained, resizing either 
horizontally or vertically 


zoom full length 


f CTRL-LEFT 1 on frame [border or names tripe') toeeles [switches back 
and forth) this feature 


menu access 


I RIGHT j and hold down, on frame (border or namestripe) 
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Why Use “Click-To-Type?” 
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Focusing Attention 



Normally, when you use suntools, you choose the window you want to type 
in by moving the cursor inside the boundary box of that window. Then, when- 
ever you type, the characters appear in that window, at least as long as you don’t 
move the cursor. This is called the “cursor-in-window” or “ mouse- to-type” 
model. 

However, you can choose windows by an alternative method, called ‘ ‘click-to- 
type.” With “click-to-type,” you click the left or middle mouse button inside 
the window you want to type in, at a time when you aren’t holding down any 
function keys. Then, no matter where you move the cursor, the characters you 
type will appear in the window that you chose. 



To choose windows by “click-to-type,” rather than by moving the cursor inside 
a window boundary box, you must start suntools with the -S option, or 
specify “click-to-type” using defaultsedit. 



This section describes two reasons why you might want to use “click-to-type,” 
rather than the standard method of choosing windows. 

When you edit in a text subwindow of the text facility and you want to copy 
material from another text subwindow, you must be careful to press the 1 Getl 
key before exiting from the first subwindow, and remember to return to the cur- 
sor to the first window before you continue typing. 

Similarly, while using dbxtool, you cannot move the cursor into the source 
window to select a location for a breakpoint, or move the cursor into the control 
panel to perform some operation, and then type a command without first having 
to return the cursor to the command subwindow. If you invoke an application 
that creates a window, from a shelltool, and then continue typing to your 
shelltool while waiting for the tool to finish initializing, the characters that 
you type to the shell may suddenly be directed to the tool whose window has just 
come up in an area that intersects the cursor. 
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How to Use “Click-To-Type” 



An alternative to this user interface is the “click-to-type” model, in which the 
destination for mouse events and destination for keyboard events may be dif- 
ferent. With this model, the destination for keyboard events is not changed until 
the user moves the mouse into another window and clicks the left (to choose the 
window and select a location) or middle (to choose a window while preserving 
the current location) mouse button. Thus, you can move the mouse outside of the 
window that you are editing, for example, to click buttons in a control panel, or 
to scroll or make a secondary selection in another window, and you don’t have to 
return the mouse to the first window to type or edit there. 

Specify your choice of the “cursor-in- window” or “click-to-type” model of 
user interface using default sedit. If you don’t specify your choice, you 
will get “cursor-in- window.” 

Regardless of which user interface you employ, the visual feedback is the same: 
the border of the subwindow that has the keyboard focus darkens, and a blinking 
triangular or solid rectangular caret appears in the subwindow with die current 
focus of attention. 

Carets in subwindows that don’t have the current focus of attention are “sha- 
dow’ ’ carets, either gray diamonds or rectangular outlines. 
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Modifying Your Root Menu 



When you want to construct a root menu other than the default root menu that 
sunt oo Is uses, you must: 

□ Construct a file with your root menu information 

□ Tell de f au 1 1 s e dit the name of the file you chose to store your root 
menu information 

□ Exit suntools 

□ Restart suntools 

Later in the chapter, you can learn how to make a custom walking or stacking 
root menu, and in the last section, how to make a root menu with icons for the 
items you can pick. 



15.1. Constructing a Root The easiest way to construct a file containing your root menu information is to 

Menu File look at the file suntools uses to store its root menu information, and to glean 

what other information you need from your . suntools file or using the 
toolplaces command. 



The Default Root Menu File The file that suntools uses to store its root menu information is 

/usr/lib/ . rootmenu which looks like this: 
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Figure 15-1 Root Menu File for sunt oo Is 



venus% cat /usr/lib/ . rootxnenu 
# 



# suntools root 


menu 


tF 

"ShellTool" 


shelltool 


"CommandTool" 


cmdtool 


"MailTool" 


mailtool 


"TextEditor" 


text edit 


"Default sEditor" 


defaultsedit 


"IconEditor" 


iconedit 


"DbxTool" 


dbxtool 


"PerfMeter" 


perfmeter 


"GraphicsTool" 


gfxtool 


"Console" 


shelltool -C 


"Lock Screen" 


lockscreen 


"Redisplay All" 


REFRESH 


"Exit Suntools" 


EXIT 



venus % 



One important point is that this file doesn’t have any blank lines in it, especially 
not at the end of the file, sunt ools displays an error when it see a blank line 
in a root menu file. 

However, you can separate the two columns with tab characters. 

In the left column of the file, surrounded by quotation marks, are the labels for 
the items that appear on the root menu. In the right column are the programs that 
you run when you pick each menu item. 

For example, the first label and program name are "Shelltool" and 
shelltool. The label, "Shelltool" appears without quotation marks on 
the actual root menu and, when you pick that item, you start a shelltool. 

The program next to the "Console" label is shelltool -C, which runs a 
modified shelltool called a console window. You shouldn’t run more than one 
console window at a time. 

You can put options after the program name, and commands to run within the 
program, just as when you construct your own . suntools file. 

Finally, REFRESH and EXIT are two special indicators to suntools that 
you want to refresh the entire screen, or to exit from suntools. 



Make Your Own Root Menu By looking at your . suntools file, and running toolplaces when you 

File like the way you’ve set up the windows on your screen, you can come up with a 

set of window attributes for each window you want to pick from your own root 
menu. 
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Note: Remember to make sure not 
to put any blank lines in the root 
menu file, especially not at the end 
of the file. 



Put all of those attributes into a file in your home directory, designing the file 
after the example of the standard /usr / lib/ . rootmenu file, and give the 
file the traditional . rootmenu filename, so you can remember where you’ve 
put your root menu information. 



15.2. Inform 

defaultsedit of 

Your Filename 



To inform SunView that you want to use your own root menu file: 

□ Start defaultsedit 29 

□ Select the SunView category 

□ Select the Rootmenu_filename option 



Note: Once you have set your root 
menu filename with 
defaultsedit, you won’t have to 
exit and restart suntools to see 
the effects of changes you’ve made 
to your root menu file. 



□ Type the name of the filename you desire as the setting for the 
Rootmenu_f ilename option 

□ Select the I Save 1 panel button in defaultsedit. 

□ Quit defaultsedit bv selecting the I OuiT) panel button. 
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15.4. 

defaultsedit, the menu will appear as a new-style walking menu or as an 
old-style stacking menu. 

The walking menu configuration stores the hidden menu items in pull-right 
menus; whereas the stacking menus hides them in the lower overlapping menus. 

All you have to do is this — construct a root menu file that refers to root menu 
extension files. Here is an example: 

Figure 15-2 A Root Menu File That Refers to Extension Files 



f 

# 








# 

4L 


suntools root 


menu 




# 

shell 


MENU 


rootmenu . shell 




edit 


MENU 


rootmenu . edit 




mail 


MENU 


rootmenu .mail 




rlogin 


MENU 


rootmenu . rlogin 




tool 


MENU 


rootmenu . tool 




prog 


MENU 


rootmenu . prog 


j 



Exit and Restart 

suntools 



After you exit and restart suntools, and you pop up the root menu, your new 
root menu should appear. 



Walking or Stacking 
Root Menus 



You can construct a walking or stacking root menu. Depending on how you have 
set the Walking_Menus option in the SunView category of 



Put the character string MENU in the program location of the right column, fol- 
lowed by a tab character and the filename of the root menu extension file. 



29 For more information on defaultsedit, see Section 11.1 . 
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On your screen, the extended root menu looks like this: 



Figure 15-3 



The Extended Root Menu 




Here is an example of one of the root menu extension files: 



Figure 15-4 



Note: The lines beginning with the 
-wp option have wrapped around 
the end of the screen, and are actu- 
ally part of the previous line. 



A Root Menu Extension File 

. 

venus % cat . rootmenu . shell 



shell 


" . rootmenu" extension 


file 










ShellTool" 


shelltool 


-Wp 


0 


66 -Ws 


570 


715 


-WP 640 0 














CommandTool" 


cmdtool 












Console" 


cmdtool 


-Wp 


0 


0 -Ws 


570 


67 


-WP 0 0 


-W1 "« CONSOLE »" - 


WL console 


-C 







venus % 

s > 
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Here is what the root menu extension file produces when you’ve set SunView to 
the new-style walking menu: 



Figure 15-5 Pull-Right Menu from Custom Root Menu 




15.5. Using Icons to Illustrate 
Your Root Menu 



Now that you’ve extended your root menu by replacing the right column of pro- 
grams with additional menus, you can illustrate your root menu by replacing the 
left column of labels with icons. 



Shopping for Icons You can pick from the icons stored in the /usr/include/images directory. 

All of the files with filenames ending in . icon, such as 

lockscreen . icon, nautilus . icon, and terminal . icon, are icons. 



Inserting the Icons into the 
Root Menu 



Replace the left column of labels, surrounded by quotation marks, with a new 
column of icon filenames surrounded by a less than character (<) on the left and a 
greater than character (>) on the right. Here is the extended root menu file with 
icons, rather than labels: 
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Figure 15-6 Root Menu File With Icons 



r 

venus % cd 

venus % cat . rootmenu 

JL 






ir 

# suntools root menu 


</usr/include/images/terndnal . icon> 


MEND 


. rootmenu . shell 


</usr/include/images/textedit . icon> 


MENU 


. rootmenu . edit 


</usr/include/images/mail . icon> 


MENU 


. rootmenu . mail 


</us r/ include/ images /hello_wor Id. icon> 


MENU 


. rootmenu . r login 


</usr/include/images/clock . rom. icon> 


MENU 


. rootmenu . tool 


</usr/include/images/lockscreen . ioon> 
venus % 

S 


MENU 


. rootmenu . prog 

j 



This is what the illustrated and extended root menu looks like: 



Figure 15-7 



Illustrated Root Menu 




Now, you know how to modify your root menu. 
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16.1. Modifying Tty 

Subwindow Behavior 



Page Mode On/Off 
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Modifying Sub window Behavior 



You may want to modify the behavior of your sub windows, for example to 
assign new functions or filters to keys. To modify a subwindow in this way, you 
put a particular file in your home directory. For tty subwindows like 
shelltool, use the . tty swrc file; for text subwindows like textedit, 
use the . text swrc file. 

Be careful about trying to assign new functions to the function keys used by the 
text facility or to the arrow keys. When you start up a sub window within sun- 
tools, the text facility assumes control of your text facility function keys, disal- 
lowing any other functions you may have assigned to those keys. 30 

When your sub window displays: 

.tty swrc error '.keyname cannot be mapped. 

it means that your subwindow read a . tty swrc file that specified key func- 
tions that conflict with the text facility function key assignments. 

The following sections describe modifying tty and text subwindow behavior, 
including an explanation of how to map functions to the arrow keys. 



When you put a . ttyswr c file in your home directory, you can map, or assign, 
alternate functions to keys and set on or off the page mode , or scrolling behavior, 
of your tty subwindows. 



Page mode, with settings on or off, describes the scrolling behavior of the tty 
subwindow. 

When you type cat filename to look at a long file, the text scrolls by on a tty 
subwindow, so you probably miss what you were looking for in the file. When 
the file scrolls by like this, page mode is off. 

However, you can turn page mode on by picking the Page Mode On item on 
the tty menu, accessible by pressing the right mouse button while the cursor is 
inside the tty subwindow. 



30 



For information on setting up your function keys, see Section 8.1 . 
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When page mode is on, text scrolls by one page at a time with a tiny stop sign 
appearing on the screen at the end of each page. When you want to see the next 
page, type any character, or select the Continue item in the tty menu. 

By default, page mode is off in tty subwindows. However, you can set the 
default to page mode on with a specification in your . tty swrc file described 
below. 



Mapping Functions to Keys Several window applications provide a terminal emulator , or a program that runs 

a command interpreter subwindow, or shell subwindow, in some part of the 
application. When you type to this subwindow, die application passes the keys- 
trokes to the program running in it, rather handling them itself. Output from pro- 
grams run in this way displays in the subwindow. 

Whenever you start up a tty subwindow, it looks for a . tty swrc file in your 
home directory, and reads it if the file is there. In that file, you can map new 
functions to keys, in effect creating your own terminal emulator. 31 



Format of the . tty swrc 
File 



The format of the . ttyswrc file is: 



# 

set variable 
mapi key text 
mapo key text 



Comments. 

Turn on the specified variable. 

When key is typed pretend text was typed. 
When key is typed pretend text was output 



The only currently defined variable is pagemode. A key must be one of: ( LI 1 
through CHI) , LED through CUD, LIU through ( T15) , [ R1 ) through [ R15 ] , 
and 1 lHm I or t RIGHT 1 . Text may contain escapes, such as \E for escape, \n 
for newline, and "X for 1 CTRL-X1 . 32 



It is possible for a terminal-based program to send special escape sequences to an 
application to perform certain operations. These escape sequences may also be 
sent using the mapo function described above. You can send the following 
functions to the window application in which the tty subwindow resides, not to 
the tty subwindow itself. 



\E [It 
\E[2t 
\E [3t 

\E [ 3 ; TOP ; LEFTt 
\E[4t 

\E [4;WIDTH;HTt 

\E[5t 

\E[6t 



-open 

- close (become iconic) 

- move, with interactive feedback 

- move, to TOP LEFT (pixel coordinates) 

- stretch, with interactive feedback 

- stretch, to WIDTH HT size (in pixels) 

- top (expose) 

- bottom (hide) 



31 When using the default kernel keyboard tables, you can’t map the keys (TO, 1 LEFT ] . [ RIGHT ) . 

f BREAK 1 . fR8) . f RIO) . [ R12) . and [ R14 1 in this way because they send special values to the terminal emulator 
subwindow. See the kbd Man Page, Section 5 of the Man Pages, for more information. 

32 See the termcap Man Page, Section 5 of Man Pages, online for the format of the string escapes that the 
tty subwindow recognizes. 
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\E[7t -refresh 

\E [ 8 ; ROWS ; COLSt- stretch, to ROWS COLS size (in characters) 

\E [ 1 It - report if open or iconic by sending \E [ It or \E [2t 

\E [ 13t - report position by sending \E [ 3 ; TOP ; LEFTt 

\E [ 1 4t - report size in pixels by sending \E [ 4 ; WIDTH ; HTt 

\E [ 1 8 1 - report size in characters by sending \E [ 8 ; ROWS ; COLSt 

\E [ 2 Ot - report icon label by sending \E] Llabel\E\ 

\E [ 2 It - report tool header by sending \E] llabel\E\ 

\E] Ktext>\E\ - set tool header to <text> 

\E] Kfile>\E\ - set icon to the icon contained in <file>; 

<file> must be in iconedit output format 
\ E ] lj<label> \E\ - set icon label to <label> 

\E [ >OPT ; . . . h - turn OPT on (OPT = 1 => pagemode), e.g., \E [ >1 ; 3 ; 4h 

\E [ >OPT ; . . . k - report OPT; sends \E [ >OPTl or \E [ >OPTh for each OPT 

\E [ >OPT; ... 1 - turn OPT off (OPT = 1 => pagemode), e.g., \E [ >1 ; 3 ; 41 

As an example of the use of this facility, you can put these aliases into your 
~ / . cshrc file: 

# dynamically set the name stripe of the tool: 
alias header 'echo -n " * [ ] 1\ ! * * [\"' 

# dynamically set the label on the icon: 
alias iheader 'echo -n " * [] L\ ! ** [\"' 

# dynamically set the image on the icon: 
alias icon 'echo -n " ~[]I\!*~[\"' 

The next section demonstrates an example of a . ttyswr c file into which you 
can insert these function mappings. 
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Example . ttyswr c File Here is an example . ttyswrc file that you can copy into your home directoiy: 

Figure 16-1 Example . ttyswrc File 



venus % cat .ttyswrc 
# 

# ttysubwindow startup file 

# 



set 


pagemode 


# Top: 
mapo 


Tl 


E[5t 


# Close 


: 




mapo 
# Move: 


T2 


E[2t 


mapo 


T3 


E[3t 


# Stretch: 




mapo 


T4 


E[4t 


# Bottom: 




mapo 


T5 


E[6t 


# Refresh: 




mapo 


T6 


E[7t 


# Move 


(non- 


interactive) to top left: 



mapo T7 E[3;l;lt 

# Stretch in chars (non-interactive) to half high: 

mapo T8 E[8;10;80t 

# Stretch in chars (non-interactive) to normal size: 

mapo T9 E[8;34;80t 

# Commands (very left keys, not setup) : 

mapi L3 jobs 

mapi L5 mail 

mapi L7 Is -F 

mapi L9 more errs 

# Editing: 

# Bracket word in italic escapes while in vi: 

mapi R4 iEeaE 

# Bracket word in bold escapes while in vi: 



mapi 


R5 


iEeaE 


# Mail: 






mapi 


R1 


dt 


mapi 


R2 


s +planning\ndt\n 


mapi 


R3 


s +bugs\ndt\n.sp 



venus % 

V > 



Of course, you can modify this file to create a 



.ttyswrc file of your own. 
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16.2. Modifying Text 

Subwindow Behavior 

Mapping Filters or Functions 
to Keys 



Format of the .textswrc 
File 



Each time you create a text subwindow, it looks for a .text swr c file in your 
home directory and reads it if the file is there. 



The text facility provides the ability to pipe the primary selection to an arbitrary 
program, or filter (as stdin), and insert the resulting output (stdout) at the 
caret. If the primary selection is in pending-delete, die output from the filter will 
replace it. 

For example, piping a selection through f mt will cause all of the long lines to 
be truncated to 72 characters. Piping a selection through indent will format it 
according to the defaults specified in ~ / . indent . pro 33 

You can bind filter to unused function keys, in other words, to 1 R1 1 through 
CUD, I FI 1 through I F9 1 . or when you have mapped the standard editing opera- 
tions to the function keys on the right side of the keyboard, to 1 LI 1 through 

cnm. 



Here is the basic format of each entry: 

key-name FILTER 
command-line 

For example, 

KEY_RIGHT (14) FILTER 
fmt 

causes 1 R141 to pipe the current selection through fmt, and 

KEY_RIGHT (11) FILTER 
indent -st 

causes I Rll 1 to format the current selection. 34 

You can find the following useful filters in /usr /bin: 

insert_brackets argl arg2 

Copies argl to stdout, then copies stdin to stdout, 
then copies arg2 to stdout, in general, 
insert_brackets ( ) can be used as a 
filter for parenthesizing the selected text. If the 
selected text already has the indicated brackets, 
then insert brackets removes them. 



33 See the indent Man Page, online or in the Commands Reference Manual. 

34 s and t are options to indent that tell it to read from stdin and output to stdout. 

The program you specify must appear in a directory accessible by your search path. If the program is not found, 
or there is some other failure in the invocation of the filter, no change will occur in the document, even if the 
primary selection is pending-delete. 
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shif t_line s n Moves the selected text right n spaces (left when 

n is negative). 

capitalize Capitalize/uncapitalize the selected material, as 

follows: If everything is in caps, convert every- 
thing to lower case, for example, EDIT TOOL 
becomes edit tool. If the selected material 
consists of several words separated by white 
space, then for each word, capitalize it if it isn’t, 
lower case if it is, for example: now is the 
time becomes Now Is The Time, and vice 
versa. Finally, for material consisting of a 
sequence of one or more letters without any white 
space, if there are any lower case letters, convert 
everything to uppercase, for example: 
ad just_jpending_delete becomes 
AD JUST_PENDING_DELETE. 

The file /usr / lib/ . text swr c contains the following bindings for the right 
hand function keys: 

I R1 1 Italics 

CM) Bold 

[R3l Listing font 

[ R4 1 Capitalize 

I R51 Parenthesize 

[ R6 1 Insert/remove 

[ R7 1 2 points smaller 

[ RIO I Shiftlines left 1 tab 

[ Rll 1 Indent 

[ R12 1 Shiftlines right 1 tab 
[Rl4l fmt 

[ R1S 1 Insert current time and date 
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Example . textswrc File Here is an example . text swrc file located in /usr/lib/ . textswrc: 
Figure 16-2 Example . textswrc File 

f > 

venus% cat: /usr/lib/. text swrc 

/* textswrc file */ 

KEY_RIGHT ( 1 ) FILTER 
insert_brackets 
/* 

* insert_brackets inserts the indicated characters around the selected text. 

* If the text is already bracketed with these characters, it removes them. 

* At some point in the future, the remove option will be invoked by holding 

* down SHIFT key while hitting function key. 

*/ 

KEY_RIGHT (2 ) FILTER 
insert_bracket s 

KE Y_R I GHT ( 3 ) FILTER 
insert_brackets 

KEY_RIGHT ( 4 > FILTER 
capitalize 
/* 

* capitalize/uncapitalize selected material as follows: If there are no 

* lower case characters, convert everything to lower case. 

* Example: EDIT TOOL => edit tool. 

* If there are any lower case letters, convert everything to uppercase. 

* Example: adjust_pending_delete -> ADJUST_PENDING_DELETE 

* 

* If characters consist of several words separated by white space, then for each 

* word, capitalize the first letter it if it isn't, lower case if it is. 

* Example: now is the time => Now Is The Time, and vice versa. 

*/ 

KEY_RIGHT (5) FILTER 
insert_brackets ( ) 

KEY_RIGHT ( 6 ) FILTER 
insert_brackets " " 

KEYRIGHT (7 ) FILTER 
insert_brackets 

Continued on next page 



.A 
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KEY_RIGHT (10) FILTER 
shift_lines -t -1 
/* 

* shifts selected lines left the indicated number of tab stops tab stops 

* computed the following way: if any spaces are seen on the first line tab 

* stops = 4. Otherwise, look in .indent. pro for corresponding value (you can 

* use the indent_tool to set up your . indent .pro) . If no .indent. pro, assume 

* 8. Note this means that if the user has that user can specify 8 in his 

* .indent. pro, but for those files that he has explitily formatted using 4 

* space indentation this will do the right thing provided that the first 

* line given to shift_lines contains some spaces. 

* 

*/ 

KEY_RIGHT (12) FILTER 
shift_lines -t 1 

/* shifts selected lines right the indicated number of spaces */ 

KEY_RIGHT (11) FILTER 
indent -st 

/* invoke indent on the selected material, using the options specified in 
* . indent . pro 
*/ 

KEY_RIGHT (13) FILTER 

whenis -nw now 

/* inserts current time */ 

KEY_RIGHT (14) FILTER 
fmt 

/* pass the selected material through fmt */ 
venus % 



As with the . tt y swrc file, you can modify this example file to create a 
. t ext s wr c file of your own. Caution — read the next section before copying 
this example file into your home directory. 

Mapping Functions to the If you absolutely have to map functions to your arrow keys, as in the example 

Arrow Keys . t ext s wr c above, you must add: 

setkeys noarrows 

on a line by itself in your . login file, so SunView won’t reassign the arrow 
keys. 



sun 

microsystems 






17 



Other Features 

Other Features 169 

17.1. lockscreen 169 

17.2. screendump 170 




17 



Other Features 



Two other useful features of the window system are lockscreen and 
screendump. lockscreen locks your screen and displays the life 
graphics demo when you want to stop work for a while, s cr eendump takes a 

picture of everything on the screen, so that you can save the image, or print it 
out. screendump was used to produce most of the pictures in this document. 

17.1. lockscreen To activate lockscreen, choose the Lock Screen menu item on the root 

menu, lockscreen clears the screen, then displays the life graphics demo, 
restricting access to your machine. 

Figure 17-1 lockscreen Displays the life Graphics Demo 
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Note: When the system crashes for 
some reason during a time when 
lockscreen is running, then the 
system will probably reboot itself, 
leaving the system login prompt, 
without any graphics demo, on the 
screen. 



To start work again, click the left mouse button to clear the life program 
display from your screen. Then, locks cr een prompts you for a password. If 
you type your password correctly, lockscreen displays your windows on the 
screen, identical to when you locked the screen. 

To learn more about lockscreen, such as how to specify other graphics 
demo displays, see the lockscreen Man Page, online or in the Commands 
Reference Manual. 



17.2. screendump screendump allows you to take a snapshot of the screen at a given time and 

store it in a file or print it out on certain printers. Simply type screendump > 
filename to save the screen image in a file. 

You may want to rlogin to your workstation from another machine, so that 
when you type screendump to your workstation, your command line doesn’t 
appear in the screen image. See Using the Network: Beginner's Guide for more 
information about rlogin. 

For more information about screendump, see its Man Page, online or in the 
Commands Reference Manual. 
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Further Reading 



When you want to read more, start with these manuals: 

Mail and Messages: Beginner’s Guide 
Games, Demos, and Other Pursuits: Beginner s Guide 
Doing More With UNIX: Beginner’s Guide 
Using the Network: Beginner’s Guide 

SunView Programmer’ s Guide 

S unView System Programmer’ s Guide 

The Pixrect Reference Manual 

Commands Reference Manual 

System Administration for the Sun Workstation 
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Glossary 



This glossary lists SunView terms in common use, especially in this manual. 

The quick reference, located at the end of this manual provides a quick reference 
for the mouse buttons and the function keys. 



adjusting a selection 

Moving the cursor and clicking to make a selection encompass more or 
fewer characters. 



caret 

A blinking triangle, gray diamond, static solid or “shadow” rectangle shape 
that indicates the insertion point in a text subwindow. 



click 

Press and release a mouse button. 



click-to-type 

One method for choosing the window to which what you type on the key- 
board will go — click the left or middle mouse button while the cursor is 
within a window border to focus attention on that window. Until you click 
again while the cursor is within another window border, everything you type 
on the keyboard will be sent to the window that has the current focus of 
attention. 



command subwindow 

A text sub window that includes a command interpreter, like cmdtool. 
cursor 

The distinctive shape, usually an arrow pointing “north-west,” that follows 
and indicates the position of the mouse. 

cursor-in-window 

One method for choosing the window to which what you type on the key- 
board will go — move the cursor within a window border to focus attention 
on that window. 



current selection 

The same as primary selection. 



focus of attention 

The window to which characters typed on the keyboard will be sent, picked 
by a cursor with either the “cursor-in- window” or “click-to-type” model. 
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frame 

The border and namestripe surrounding a subwindow, 
frame menu 

The menu you obtain by holding down I RIGHT 1 over the border or names- 
tripe of any window. Contains the operations Close, Move, Resize, 
Expose, Hide, Redisplay, and Quit. 

insertion point 

The place where the next character you insert will go, usually at the caret, 
inverse video 

Reversed light and dark portions of the screen. 

[LEFT1 Left button on mouse. 

menu 

A list of operations that you can choose by clicking 1 RIGHT 1 and moving 
the cursor. Menus appear when, and for as long as, you hold down 
f RIGHT 1 . The operation occurs when you release ( RIGHT 1 with the cursor 
over a menu item. 

menu item 

The area of a menu that you choose to invoke a particular operation. 

mouse-to-type 

Same as cursor-in-window. 

new-style menu 

The same as walking menu. 

panel 

A subwindow with buttons that acts like a control panel for an application, 
including certain text facility editing operations. 

pending delete selection 

A selection, either primaiy or secondaiy, made while the ( CTRL] key is 
down. Pending delete selections are automatically deleted by a subsequent 
insertion. Pending delete selections are indicated by a gray overlay. 

[ MIDDLE 1 Middle button on mouse. 

point at 

Position the cursor over, 
primary selection 

The span of text highlighted by inverse video, and marking the area for 
current editing operations. Also called the current selection. 

pull-right menu 

A menu accessible by moving the mouse to the arrow (=>) at the right of an 
item on a new-style walking menu. 

f RIGHT 1 Right button on mouse. 

root menu 

The menu you obtain by holding down I RIGHT 1 with the cursor over the 
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gray background area of the screen, 
scroll bar 

A gray column at the left of the text sub window used for scrolling and indi- 
cating position within the entire text. 

scroll button 

The box at the top or bottom of the scroll bar used for scrolling, 
scrolling 

Moving the text up or down in a subwindow; can also think of it as reposi- 
tioning the subwindow with respect to the data it displays. 

secondary selection 

A selection made while a function key is held down. The selection only lasts 
as long as the function key is held down, and is indicated by underlining the 
selected characters. These characters will be an operand to the corresponding 
function. 

select 

Indicate a span, a contiguous sequence of characters, by pointing at and 
clicking. 

selection 

A span of characters, highlighted by inverse video, underlining, or gray 
shading. 

shadow caret 

A gray diamond or rectangular outline shape that indicates the insertion 
point within a window that isn’t the current focus of attention. 

shelf 

A place where the text facility stores the text you [ Put) or I Delete I , using 
function keys. 

span 

A contiguous sequence of characters, 
stacking menu 

A menu with overlapping parts accessible by clicking the left mouse button 
while continuing to hold the right mouse button that popped up the menu. 

text menu 

The menu you obtain by holding down I RIGHT 1 anywhere inside a text 
subwindow. Contains operations such as Reset, Save, Set Direc- 
tory. 

text subwindow 

A subwindow that provides display and editing capability for text within the 
text facility. 

tiled windows 

Windows that do not overlap, forming a pattern like pieces of a mosaic. 

tty subwindow 

A subwindow that includes a command interpreter, but doesn’t support all of 




the text facility operations, for example, shelltool. 

walking menu 

A new style of menu that contains pull-right menus accessible by moving 
the mouse to the arrow (=>) at the right of an item on the main menu. 
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A 

aborting an operation, 106 
accelerator, 143 

mouse button, 143 
to end of text subwindow, 143 
Adjust_is_jpending_delete, 115 
adjusting a selection, 77 
level, 104 

adjusting a window, 25 
advanced editing, 99 
advanced scrolling, 106 
advanced selecting, 102 
again operation, 112 
arrow key problem, 166 
attention 

focus, 147 
audible bell, 127 
Auto_indent, 115 

B 

background processing, 73 
backup file, 88 
basic editing 

summary, 94 
bell 

audible, 127 
bitmap screen, 4 
boundary box, 21 

c 

caret, 5 

blinking triangular, 5, 77, 148 
gray diamond, 5, 148 
insertion point, 77 
rectangular outline, 148 
rectangular solid, 5, 148 
shadow, 5, 148 
Caret to top, 99 
cbreak mode problem, 124 
changing menu style, 128 
changing the working directory, 91, 101 
changing window location, 20 
changing window size, 24 
choosing a menu item, 20, 34 
choosing a window, 13 
clearing the window, 94 



click-to-type, 147 
clicking mouse button, 12 
clipping long lines, 101, 114 
Close & Save, 100 
Close & Store, 100 
cmdtool, 121 

cbreak mode problem, 124 
icon, 12 

interpretation of control characters, 123 
man problem, 124 
more problem, 124 
moving to the command prompt, 123 
“raw” mode problem, 124 
read-only boundary, 123 
rlogin problem, 124 
su problem, 124 
command 

setkeys, 66 
toolplaces, 47 
command facility, 121 
cmdtool, 121 
command sub window, 121 
dbxtool, 121 

interpretation of control characters, 123 
read-only boundary, 123 
command interpreter, 12 
command subwindow, 72, 121 

Commands Reference Manual, 48, 49, 69, 115, 129, 131, 133, 139, 
163, 170 

compatibility, 85 
console window, 10 
constrained movement cursor, 22 
constrained resizing cursor, 25 
constrained window adjusting, 25 
constrained window dragging, 22 
control subwindow, 132 
copy from there to here, 108 
copy here to there, 109 
copy here to there, go there, 110 
copy here, replace there, 110 
copy there, replace here, 109 
copying a selection, 84 
between windows, 85 
creating a file from scratch, 94 
creating a window, 35 
current directory 
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current directory, continued 
changing, 91 
setting, 91 
cursor, 5 

constrained movement, 22 
constrained resizing, 25 
editing, 130 
moving, 11 

unconstrained movement, 23 
unconstrained resizing, 26 
cursor-in-window, 147 

D 

defaults, 127 

defaultsedit, 127, 148 

Adjust_is_pending_delete, 115 
Auto_indent, 115 
category, 128, 129 
Edit_back_char, 116 
Edit_back_line, 116 
Edit_back_word, 116 
Lower_context, 116 
option, 128 

Scratchwindow integer, 116 
deleting a character 
left, 78 
right, 79 

deleting line breaks, 80 
deleting with a function key, 82 
deleting words and lines, 81 
Destroy view, 99 
destroying a view, 100 
diagram 

function keys, 66 
displaying the line number, 100 
displays 

special-purpose, 137 
documentation 
roadmap, 173 

Doing More With UNIX: Beginner’s Guide, 123 
dragging a window, 22 

E 

Edit On/Off, 99 
Edit_back_char, 1 16 
Edit_back__line, 116 
Edit_back_word, 116 
editing, 65 

advanced, 99 
intermediate, 89 
basics, 94 

editing cursors, 130 
editing icons, 130 
editing operation 

copy from there to here, 108 
copy here to there, 109 
copy here to there, go there, 1 10 
copy here, replace there, 110 
copy there, replace here, 109 
exchange here and there, 111 
move from there to here, 109 



editing operation, continued 

move from there, replace here, 109 
move here to there, 1 10 
move here to there, go there, 111 
move here, replace there, 110 
there- to-here, 108 
editing tool, 127 

defaultsedit, 127 
fontedit, 131 
iconedit, 130 
empty text subwindow, 73 
error 

.ttyswrc error: keyname cannot be mapped., 
159 

exchange editing operation, 111 
exchange here and there. 111 
exposing a window, 40 

F 

features, 169 
file 

backup, 88 
. login, 66 
. suntools, 48 
file insertion, 100 
Find, 99 

focusing attention, 147 
font, 127 
fontedit, 131 

control subwindow, 132 
editing area, 132 
message subwindow, 132 
options, 132 
proof subwindow, 132 
scrollbar, 132 
frame menu, 19, 20 
f ramedemo, 138 
function 

map to key, 159 
function key 

AGAIN, 112 
FIND, 111 
Open, 143 
Stop, 69, 105, 106 
function keys, 65 
diagram, 66 
keyboard side, 65 
labels, 66 

Further Reading, 173 

G 

Get from file, 99 
gfxtool, 137 
graphics program 

f ramedemo, 138 
life, 169 
graphics tool, 137 
gray 

menu item, 99 
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H 

header 

menu, 19, 20, 34 
hiding a window, 41 

I 

icon, 127 

cmdtool, 12 
definition, 10 
editing, 130 
nautilus, 121 
shelltool, 12 
iconedit, 130 
inserting a file, 100 
inserting text, 77 
caret, 77 

highlighting characters, 77 
insertion point, 71, 77 
instruction box, 20 
getting rid of, 24 
intermediate editing, 89 
interpretation of control characters, 123 

K 

key 

mapping functions to, 159 
keyboard, 4 
labels, 66 
Sun-1, 65 

Sun-1 and Stop function key, 69 
Sun-2, 65 
Sun-3, 65 
keyboard type, 65 
keys 

function, 65 

L 

labels, 66 

left-handed function keys, 65 

level of selection, 102 

life, 169 

Line break, 99 

Load file, 99 

loading a file into a window, 100 

loading a file into textedit, 73, 92 

lockscreen, 169 

. login file, 66 

Lowe r_cont ext, 116 

M 

Mail and Messages: Beginner’s Guide , 12 

man problem, 124 

manual 

Commands Reference Manual, 48, 49, 69, 115, 129, 131, 133, 
139, 163, 170, 173 

Doing More With UNIX: Beginner’s Guide, 123, 173 
Games, Demos, and Other Pursuits: Beginner’s Guide, 173 
Getting Started with UNIX: Beginner’s Guide, 4 
Mail and Messages: Beginner’ s Guide, 12, 173 
S unView Programmer’s Guide, 173 



manual, continued 

SunView System Programmer' s Guide, 173 
System Administration for the Sun Workstation, 173 
The Pixrect Reference Manual, 173 
Using the Network: Beginner' s Guide, 123, 170, 173 
map key functions, 159 
error, 159 
menu, 20, 34 

accelerator, 143 
changing style, 128 
choose an item, 34 
choosing an item, 20, 34 
frame, 19, 20 
gray item, 99 
header, 19, 20 
new-style, 70, 128 
old-style, 19, 62, 70, 128 
pop-up, 19, 20, 34 
pull-right, 70, 89 
root, 34, 72 
stacking, 62, 70 
text, 99 

tty subwindow, 159 
walking, 70, 89, 128 
message subwindow, 132 
modifying subwindow behavior, 159 
modifying text sub window behavior, 163 
modifying tty subwindow behavior, 159 
modifying your root menu, 151 
more 

page mode alternative, 160 
more problem, 124 
mouse, 4 

clicking button, 12 
moving the cursor, 1 1 
position, 1 1 
problem, 1 1 
stuck, 1 1 
mouse button 

accelerator, 143 
mouse tablet, 4 
mouse-to-type, 147 
mousing ahead, 114 
move from there to here, 109 
move from there, replace here, 109 
move here to there, 110 
move here to there, go there, 111 
move here, replace there, 1 10 
move to top of text subwindow, 100 
moving a selection, 83 
moving a window, 20 
moving the cursor, 1 1 
moving to the command prompt, 123 
moving to the end of the file, 123 
multi-clicking, 102 

N 

namestripe, 35, 88, 91, 93 
nautilus icon, 121 
new-style menu, 70 
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o 

old-style menu, 19, 62, 70 
Open function key, 143 
other features, 169 

P 

page mode, 160 
panel, 108 

pending-delete selection, 102, 105 
pixel, 4 

pop up a menu, 19, 20, 34 
primary selection, 71 
problem 

window system starting, 9 
proof sub window, 132 
pull-right menu, 70, 89 
Put then Get, 99 

Q 

quit the editor, 94 

R 

“raw” mode problem, 124 
read-only boundary, 123 
reinserting deleted text, 83 
remote login, 170 

repeating text facility commands, 1 12 
replacing text selections, 84 
Reset, 73, 99 
reset the window, 94 
resetting a text subwindow, 100 
resizing a window, 24 
returning to the previous edit location, 107 
right-handed function keys, 65 
rlogin, 170 
rlogin problem, 124 
root menu, 34, 72 
default file, 151 
extension file, 154 

inform default sedit of filename, 153 

modifying, 151 

new-style, 153 

old-style, 153 

stacking, 153 

walking, 153 

s 

Save, 99 

Save & Quit, 100 
Save & Reset, 100 
Save file, 100 
save screen image, 170 
saving a file, 100 
saving your editing 

another filename, 88 
current filename, 88 
scratch text subwindow, 89 
Scratch_window integer, 116 
screen, 4 



screen, continued 
bitmap, 4 

screen snapshot, 170 
screendump, 170 
scroll bubble, 87 
scrollbar, 87 
scrolling, 71 

advanced, 106 
backward, 87 
forward, 87 
page at a time, 87 
page mode, 160 
text goes down, 87 
text goes up, 87 
thumbing, 107 
to position in document, 107 
tty subwindow, 160 
scrolling text, 86 
searching for text selections. 111 
secondary selection, 102, 104 
problem, 105, 106 
stuck, 105, 106 
Select line #,99 
selecting a character, 75 
selecting a character span, 75 
selecting text, 75 
selection 

adjusting, 77 

adjusting at higher levels, 104 
advanced, 102 
by line number, 100 
caret, 77 
copying, 84 

highlighting characters, 77 
level, 102 
moving, 83 
multi-clicking, 102 
pending-delete, 102, 105 
primary, 71 
problem, 105, 106 
searching fora. Ill 
secondary, 102, 104 
stuck on secondary selections, 105, 106 
Set Directory, 99 
set keys 

no arrows, 166 
set keys command, 66 
setting the current directory, 101 
setting the working directory, 91 
shelf, 71, 83 
shell, 12 
shelltool, 12 
she lltool icon, 12 
shrinking a window, 24 
snapshot of screen, 170 
special-purpose displays, 137 
Split view, 99 
splitting a view, 100, 107 
stacking menu, 62, 70 
starting suntools, 9 
starting textedit, 72 
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starting the window system, 9 
Stop function key, 69, 105, 106 
Sun-1 keyboard, 69 
stopping an operation, 106 
Store & Quit, 100 
Store to named file, 100 
storing a file, 100 
storing window attributes, 47 
storing your editing 

another filename, 88 
stretching a window, 24 
stuck mouse, 1 1 
su problem, 124 
sub window, 65, 137 
command, 72, 121 
command facility, 121 
modifying behavior, 159 
scratch, 89 
text, 65 
tiling, 65 
tty, 72 

subwindow tty, 108 
summary 

text facility, 116 
suntools 
starting, 9 

. suntools file, 48 
SunView 

accelerator, 143 

T 

tablet, 4 

tektool, 138 

Tektronix, 137, 138 

terminal emulator, 137, 138, 160 

terminology, 71, 102 

text facility, 65 

aborting an operation, 106 

accelerate to end of text subwindow, 143 

accelerator, 143 

adjusting a selection, 77 

advanced scrolling, 106 

advanced selecting, 102 

again operation, 112 

arrow key problem, 166 

change working directory, 101 

changing directory, 91 

clearing the window, 94 

clip long lines, 101 

clipping long lines, 1 14 

command subwindow, 72 

compatibility, 85 

copying a selection, 84 

creating a file from scratch, 94 

deleting a character, 78, 79 

deleting line breaks, 80 

deleting with a function key, 82 

deleting words and lines, 81 

destroying a view, 100 

displaying the line number, 100 

editing, 65 



text facility, continued 

editing restrictions, 108 
file insertion, 100 
inserting a file, 100 
inserting text, 77 
loading a file, 100 
modeless, 78 

modifying subwindow behavior, 159 

modifying text sub window behavior, 163 

modifying tty subwindow behavior, 159 

mousing ahead, 114 

move to top of text subwindow, 100 

moving a selection, 83 

moving to the end of the file, 123 

multi-clicking, 102 

option, 128 

option category, 128 

pending-delete selection, 102, 105 

quit, 94 

reinserting deleted text, 83 
repeating commands, 112 
replacing text selections, 84 
reset, 100 

reset the window, 94 
saving a file, 100 
saving your editing, 88 
scrolling text, 86 
searching for text selections, 111 
secondary selection, 102, 104 
selecting a character, 75 
selecting a character span, 75 
selecting by line number, 100 
selecting text, 75 
set current directory, 101 
setting directory, 91 
splitting a view, 100, 107 
stopping an operation, 106 
storing a file, 100 
summary, 116 
text subwindow, 65 
undoing editing operations, 86 
wrap long lines, 101 
wrapping long lines, 1 14 
text menu, 99 
items, 99 

text subwindow, 65 

accelerate to end, 143 
arrow key problem, 166 
empty, 73 

modifying behavior, 163 
stuck on secondary selection problem, 105, 106 
textedit 

adjusting a selection, 77 
backup file, 88 
changing directory, 91 
clearing the window, 94 
copying a selection, 84 
creating a file from scratch, 94 
deleting a character, 78, 79 
deleting line breaks, 80 
deleting with a function key, 82 
deleting words and lines, 81 
inserting text, 77 
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text edit, continued 
loading a file, 73, 92 
modeless, 78 
moving a selection, 83 
moving to the end of the file, 123 
namestripe, 88, 91, 93 
quit, 94 

reinserting deleted text, 83 
replacing text selections, 84 
reset the window, 94 
saving your editing, 88 
scratch text subwindow, 89 
scrolling text, 86 
selecting a character, 75 
selecting a character span, 75 
selecting text, 75 
setting directory, 91 
shelf, 83 
starting, 72 

undoing editing operations, 86 
working directory, 75 
there-to-here editing operations, 108 
thumbing, 107 
tiling, 65 
tool 

cmdtool, 121 
default sedit, 148 
definition, 12 
editing, 127 
gfxtool, 137 
graphics, 137 
lockscreen, 169 
shelltool, 12 
tektool, 138 
toolplaces, 47 
tty menu, 159 
tty subwindow, 72, 108 

arrow key problem, 166 
editing restrictions, 108 
modifying behavior, 159 
scrolling behavior, 160 

.ttyswrc error: keyname cannot be mapped., 159 
typeface, 127 

u 

unconstrained movement cursor, 23 
unconstrained resizing cursor, 26 
unconstrained window adjusting, 26 
unconstrained window dragging, 23 
undoing a scrolling operation, 107 
undoing editing operations, 86 
UNIX operating system, 12 
Using the Network: Beginner’s Guide, 123, 170 

w 

walking menu, 70, 89 

choosing hidden menu item, 89 
What line #?, 99 
window 

border, 19 
boundary box, 21 



window, continued 

changing location, 20 
changing size, 24 
choosing, 13 
console, 10 
create, 35 
definition, 4 
exposing, 40 
hiding, 41 
instruction box, 20 
moving, 20 
namestripe, 19, 35 
resizing, 24 
shrinking, 24 
storing attributes, 47 
stretching, 24 
subwindow, 137 
target circle, 19 
window adjusting 
constrained, 25 
unconstrained, 26 
window dragging 
constrained, 22 
unconstrained, 23 
window system 
caret, 5 
cursor, 5 
defaults, 127 
definition, 3 
editing, 65 
option, 128 
option category, 128 
other features, 169 
problem starting, 9 
starting, 9 
window, 4 
word 

definition, 103 
working directory 
changing, 91 
setting, 91 

working directory of textedit, 75 
workstation 
parts, 4 

wrapping long lines, 101, 114 
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Windows and Window-Based Tools: Quick Reference 



This quick reference describes the text facility operations of the mouse and the function keys. 



The Mouse 

Each of the mouse buttons has a general purpose: 



(LEFT) 


selects 


1 TWIDDLE ] 


adjusts (or modifies) a selection 


FRIGHT) 


pops up a menu 



The [ SHIFT ] key toggles the “direction” of the action. 

The [ CTRL 1 key modifies the meaning of a choice or accelerator. 



Mouse By Function 



Desired Function 
open 

expose 



Mouse Button Procedure 

( LEFT1 on icon 

f LEFT 1 on frame (border or namestripe) 



hide ( SHIFT-LEFT 1 on frame (border or namestripe) 

move f MIDDLE I on comer = unconstrained, vertical and horizontal adjust- 

ment 

( MIDDITTl on middle third of edge = constrained, movement either 
horizontally or vertically 



resize 



{ CTRL-MIDDLE 1 on comer = unconstrained, vertical and horizontal 
adjustment 

I CTRL-MIDDLE 1 on middle third of edge = constrained, resizing either 
horizontally or vertically 



zoom full length 



[ CTRL-LEFT 1 on frame (border or namestripe) toggles (switches back 
and forth) this feature 



menu access 



[ RIGHT 1 and hold down, on frame (border or namestripe) 







Mouse By Button 




( MIDDLE! 


On comer = unconstrained move, 
vertical and horizontal adjustment 




On middle third of edge = constrained move, 
either horizontally or vertically 


[SHIET-MIDDlEI 


n.a. 


1 CTRL-MIDDLE! 


On comer = unconstrained resize, 
vertical and horizontal adjustment 




On middle third of edge = constrained resize, 
either horizontally or vertically 





On icon: open 

On frame (border/namestripe): 




expose 


■stfurrawaamHl 


On frame (border/namestripe): 




hide 


InNiaiBiaaiHi 


On frame (border/namestripe): 




toggles zoom (full length) 





On icon or frame 


or 


(border/namestripe) : 




pop up a menu 


I or 

















Basic Editing 




Select 


( LEFT ) to select. [ MIDDLE 1 to adjust. 


Scroll 


[ LEFT ) in scroll button to scroll forward one line. 1 RIQHT 1 to scroll backward, 
l MIDDLE 1 to scroll a paee. 


Insert 


Type characters. 


Delete 


I Delete 1 function kev. With characters adiacent to the caret, vou can use UNIX rubout. 
erase word, or line kill characters. 


Reinsert deleted text 


rOeD or [ CTRL-G 1 . 


Replace 


[ Delete ). tvpe characters. 


Move 


[ Delete 1. select destination. [ Get ]. 


Store on shelf 


(PuD. 


Copy from shelf 


fain or ( CTRL-G 1. 


Copy text from elsewhere 


Select text. [Put 1. select destination. 1 Get 1. 


Undo edits 


[ Undo ) undoes all edits since last selection, or use of 1 Get 1. [ Put 1. or [ Delete 1. 


Load a fie 


Load file item on text menu, or type name of file to empty text subwindow, fol- 
lowed bv [ ESC 1. Reset text menu item (once or twice'! makes window emptv. 


Save 


Save or Store to named file item on text menu. 


Exit 


Quit item on frame menu. 


Function Keys 





Sun-2 Keyboard 

or R1 - R15 

Caps 
Lock 



FI Key 



Again 




Stop 


Undo 




Props 


Put 




Expose 


Get 




Open 


Delete 




Find 



Either LI -L10 



Stop 


Again 


Props 


Undo 


Expose 


Put 


Open 


Get 


Find 


Delete 



Labels on Left 
Mouse on Right 



Labels on Right 
Mouse on Left 



( must type: 
setkeys lefty) 





Function Keys cont. 



Sun-3 Keyboard 

Either LI- LI 0 orRl-R15 




Labels on Left Labels on Right ( must type: 

Mouse on Right Mouse on Left setkeys lefty) 



Sun-1 Keyboard 

PF1 - PF4, etc. 




Right side of keyboard ( must type: 

for left- and right-handed people setkeys sunl) 
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